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Printing History 


New editions of this manual will incorporate all material updated since the previous edition. Update 
packages may be issued between editions and contain replacement and additional pages to be 
merged into the manual by the user. Each updated page will be indicated by a revision date at the 
bottom of the page. A vertical bar in the margin indicates the changes on each page. Note that pages 
which are rearranged due to changes on a previous page are not considered revised. 

The manual printing date and part number indicate its current edition. The printing date changes 
when a new edition is printed. (Minor corrections and updates which are incorporated at reprint do 
not cause the date to change.) The manual part number changes when extensive technical changes 
are incorporated. 

May 1984...First Edition 


Warranty Statement 

Hewlett-Packard products are warranted against defects in materials and workmanship. For Hewlett-Packard Fort Collins 
Systems Division products sold in the U S A. and Canada, this warranty applies for ninety (90) days from the date of delivery.* 
Hewlett-Packard will, at its option, repair or replace equipment which proves to be defective during the warranty period. This 
warranty includes labor, parts, and surface travel costs, if any. Equipment returned to Hewlett-Packard for repair must be 
shipped freight prepaid. Repairs necessitated by misuse of the equipment, or by hardware, software, or interfacing not 
provided by Hewlett-Packard are not covered by this warranty. 

HP warrants that its software and firmware designated by HP for use with a CPU will execute its programming instructions 
when properly installed on that CPU. HP does not warrant that the operation of the CPU, software, or firmware will be uninter- 
rupted or error free. 

HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATERIAL, INCLUDING, BUT NOT 
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett- 
Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the 
furnishing, performance or use of this material. 

* For other countries, contact your local Sales and Support Office to determine warranty terms. 












BASIC Documentation Guide 

As with most products, learning how to use the manuals properly will help you get the most use 
from the product. In order to use the manuals most effectively, you should know both the objective 
and content of each manual. 

This section describes the overall organization of the manual set and gives a brief description of 
each of the major manuals. The guide then describes the purpose of and notation used in the 
master index. An example of using the manuals and index is also provided. At the end of the 
manual, we invite you to make comments about the manuals on the enclosed card. 


Structure of the Documentation 

The information in the Series 200 BASIC documentation is divided into three general catagories, 
according to the function you are going to perform with the computer. 

• installation and operating instructions 

• programming techniques 

• language reference information 

The following paragraphs further explain the objectives and contents of each of the major manuals 
in the set. You are encouraged to pick up the manual and leaf through it as you read its description. 
Scanning the Table of Contents of each book will also help you get a quick, but broad, overview of 
the manual. 

The Installation and Operating Guides 

The Installation Guides show you how to get your computer “up and running”. There is one 
Installation Guide for each of the Series 200 computers. 

The BASIC User’s Guide describes loading the BASIC operating system, configuring BASIC, and 
introduces you to several functions. If you are unfamiliar with HP BASIC, you should read this 
guide first. 

The Techniques Manuals 

The techniques manuals help you learn the HP Series 200 BASIC language by providing task- 
oriented example programs and corresponding explanations. The techniques manuals include the 
following: 

• BASIC Programming Techniques describes writing, editing, storing, running, and debugging 
BASIC programs. The manual also describes such programming topics as string and math 
operations, using the real-time clock, and communicating with the operator. 

You may want to peruse individual chapters of interest in the main part of the manual. The 
Appendix section contains Error Messages and ASCII tables, and the Index section provides an 
index to the topics in this manual. 

• BASIC Interfacing Techniques describes how to communicate with external devices. Both 
general and interface-specific techniques are described in the manual. 
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Read Chapter 1, “Manual Overview,” to see this manual’s objectives and contents. This 
chapter also describes the organization of information in the manual and briefly describes each 
chapter. You may want to scan chapters of interest in the main part of the manual. The “Useful 
Tables” contains information relevant to interfacing, and the Index provides an index to the 
topics in this manual. 


• BASIC Graphics Techniques describes using the graphics capabilities of Series 200 computers. 
Plotting on the CRT and on external graphics devices are fully described in this manual, as well 
as using external graphics input devices. 


Chapter 1, “Introduction to Graphics,” describes the objectives of the manual and assump¬ 
tions made about your knowledge of BASIC programming. You may want to scan the indi¬ 
vidual chapters of the manual as your interest dictates. An index is also provided by this 
manual. 


The Reference Manuals 

The reference manuals are designed to aid you while coding programs by providing information 
about each keyword. The reference information consists of the following two manuals: 


• The BASIC Language Reference provides a complete “dictionary” of precise descriptions of 
every keyword in the Series 200 BASIC language. Drawings are used to graphically show the 
proper syntax of each keyword, and any parameters are described in an accompanying table. 
The semantics section describes the resultant action of different keyword syntaxes. 


The “Keyword Dictionary” section is the main part of this manual, providing the following four 
sections: 1) “Language History,” which provides valuable information about how and when 
the language has been revised and updated; 2) “Using the Keyword Dictionary,” which 
describes what information is provided by the dictionary and explains how to use it; and finally 
3) the actual dictionary entries. You should read the first two of these sections before attemp¬ 
ting to use the rest of the manual. 


The “Glossary” provides concise definitions of technical terms used throughout the manual 
set, which you can refer to as you encounter unfamiliar terms. The “Interface Registers” 
section contains listings of all status and control registers of I/O paths, CRT, keyboard, and 
optional interfaces. The contents of the “Useful Tables” and “Error Messages” sections are 
self-evident. The “Keyword Summary” section provides a complete list of keywords in the 
Series 200 BASIC language, grouped according to the function that it performs. 

• The BASIC Condensed Reference also provides a listing of all keywords and gives example 
statements for each. However, it only gives brief descriptions of the keywords, and it does not 
contain any syntax drawings or semantic information. Therefore, you will probably use it to 
check the spelling of a keyword or to see the parameters and corresponding order. 


The main sections of this manual are as follows: 1) brief explanations of system versions, data 
types, expression evaluation, graphics mapping and color model, and glossary; 2) alphabetized 
keyword listing with brief descriptions of each keyword; 3) summary of interface registers; and 
4) useful tables, including key codes, error messages, and ASCII characters. 
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Structure of the Master Index 

The master index provided by this guide references topics in the major manuals of the Series 200 
BASIC documentation. This index was created by merging all of the information in each individual 
manual’s index into one large index. 

Referencing Scheme 

Since the Master Index references topics in more than one manual, it must indicate which manual 
each entry references. To meet this requirement, each manual in the set has been designated by a 
mnemonic: 

BPT: BASIC Programming Techniques 


BIT: BASIC Interfacing Techniques 

GPT: BASIC Graphics Programming Techniques 

BUG: BASIC User’s Guide 

The following illustration shows an example of the format used in the index. 

ASCII 

Character Codes. BPT:394 

Character Set. BPT:140 

Characters, finding BUG:58,70,82,141 
Data representation ... BIT:12,138,152 

Files. BPT:206 

BUG:105,152 


Note the following key features of the index format: 

• A mnemonic is always given, in bold font and followed by a colon, before any page number(s) 
are shown. 

• Page numbers that follow the mnemonic are found in that manual (i.e., every page number is 
not preceded by the mnemonic). 

• If there are references to more than one manual given for a single topic, each mnemonic and 
pages therein begin on a new line. 

• A legend of mnemonic definitions is provided on the bottom of each page. 














Using the Manuals 

A preceding section described the objective and general contents of each type of manual in the set. 

If you are not familiar with the types of manuals and purposes thereof, please review that section. 

Now that you know what each manual is to do for you and what information it contains, you are 

ready to begin using them. 

An Algorithm for Using the Manuals 

Although simplistic, here is a “two-step” procedure that you will probably take while using your 

computer to solve your programming problem: 

1. Develop an algorithm for solving your problem, breaking it up into specific, manageable 

tasks. Work with one task at a time, expanding and refining each by using the following steps: 

a. Examine the mechanics of performing the task. Read the relevant discussion(s) in the 
appropriate techniques manual(s). Keep in mind that these manuals will probably only 
describe one or two approaches to performing elemental tasks. You may be able to 
expand or modify one of the fundamental algorithms presented to suit your particular 
needs. You may need to consult an advanced or specialized programming text to see 
how to design more complex, application-specific algorithms and programs. 

b. Determine what hardware the task will require, if any, and install it according to the 
appropriate installation or operating manual. 

c. Code your algorithm into a BASIC-language program. Consult the reference manual(s) 
to answer any questions about specific keywords. 

d. Test and debug your algorithm, which may require using both techniques and reference 
manuals. 

2. Repeat step 1, breaking each task up into finer detail, until you have the solution. 
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An Example 

Let’s look at a simple, hypothetical scenario. Suppose that you unpacked all manuals and were told 
that this is the first one to read. After reading about the overall scheme of the documentation, you 
turn to the installation manual to get your computer “up and running.” 

Once your computer hardware is set up, turn to Chapter 1 of BASIC Programming Techniques, 
“Getting Started,” to learn more about how to use the computer and BASIC language. When you 
feel comfortable using your computer to perform some elementary operations, suppose that you 
want to learn how to use mass storage files. If you were to look in the index under the topics “Mass 
storage” or “Files” you would find several references to topics on using files. 

File: 


Accessing. 

. BIT:152 

BPT:222 

ASCII. 

. BIT:154,157 


BPT:206 

BDAT. 

.BIT:153,164 


BPT:203 

Copying. 

. BPT:38,244 

BUG:106,149 


MASS STORAGE. BPT:198 

As an I/O resource. BIT:21 

File access.BIT:152,157,164 

Non-disc. BPT:220 

MASS STORAGE IS statement. 

BUG:107,113,115,149 

BPT:214 


BPT: BASIC Programming Techniques 
BIT: BASIC Interfacing Techniques 
GPT: BASIC Graphics Programming Techniques 
BUG: BASIC User’s Guide 


The references to the BASIC Programming Techniques manual (BPT) pertain to Chapter 7: Data 
Storage and Retrieval. (If you were already familiar with this techniques manual, you know that the 
tabbed section called “Data Storage” contains the desired information.) The chapter contains a 
tutorial section, appropriately called “Mass Storage Tutorial,” that gives some background on what 
mass storage is and how it is implemented on HP Series 200 computers. The chapter also contains 
a section called “Mass Storage Techniques” that presents some file-access programming tech¬ 
niques. 


The references to the BASIC Interfacing Techniques manual (BIT) pertain to Chapter 10: I/O Path 
Attributes. The discussions give other examples of accessing files with an “interfacing” perspective. 
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The references to the BASIC User’s Guide (BUG) primarily pertain to Chapter 6: Talking to 
Peripherals With BASIC. 


After reading as much of these discussions as you feel necessary, you begin writing programs. As 
you code algorithms into the computer’s BASIC language, you consult either the BASIC Language 
Reference or the BASIC Condensed Reference to answer questions about certain keywords; the 
one you consult depends on how much information you need. 

Learning additional programming skills involves the same steps as learning the one presented here. 
First, consult the appropriate techniques manual to see if your task is described. If so, read the text, 
trying any examples given. Then, as you begin to write BASIC code for the algorithm that you 
develop, consult the appropriate reference manual(s). 


Do the Manuals Work? 

As mentioned at the beginning of this manual, the Series 200 BASIC documentation has been 
designed to help you in learning to use the system effectively. This survey has been included to help 
find out how fully you think we have accomplished this goal. 

After using the manuals for a while, please take a few minutes to fill out the survey. Then tear it out 
and send it to us. We appreciate any and all comments, complaints, or commendations. 








Subject Index 



ABS. BPT:82 

Accessing Directories. BPT:246 

Accessing Files. BPT:222 

Accessing Mass Storage.BPT:210 

Accuracy. BPT.-76 

Accuracy of the Clock.BPT:275 

ACS. BPT:82 

Additive color system.GPT:102 

ALLOCATE. BPT: 74, 120 

ALPHA Key. BPT:331 

ALPHA key, HP 98203B. BUG:69,116 

ALPHA OFF. BPT:331 

ALPHA OFF statement.BUG:116,118 

ALPHA ON. BPT:331 

Alpha/Dump Alpha key, HP 46020A 

. BUG:54,116 

Angle Functions. BPT:83 

Animation, color map. GPT:96 

Anisotropic. GPT:6 

Anisotropic scaling.GPT:6 

ANY C key, HP98203A. BUG:82,141 

ANY CHAR Key. BPT:40, 144 

ANY CHAR key, HP 98203B . . . BUG:70,141 
Any char softkey, HP 46020A.. . BUG:58,141 

AP2.0. BPT:379 

Appending Program Lines.BPT:30 

AREA COLOR. GPT:52, 82 

AREA INTENSITY. GPT:52, 82 

AREA PEN. GPT:52, 81 

Arithmetic hierarchy. BUG:93,141 

Arrays. BPT:74 

Copying. BPT:92 

Declaring. BPT:74 

Dimensioning. BPT:85 

Indexing.BPT:321 

Operations. BPT:85 

Operators. BPT:96 

Reordering.BPT:99 

Sorting. BPT:100 

String. BPT:120 


Arrow keys, HP 46020A . . 

. BUG:48 

Arrow keys, HP 98203A .. 

.BUG:78 

Arrow keys, HP 98203B . . 

. BUG:65 

ASCII 

Character Codes. 

. BPT:394 

Character Set. 

. BPT: 140 

Characters, finding. 

BUG:58,70,82,141 

Data representation .... 

... BIT:12,138,152 

Files. 

. BPT:206 

ASN. 

BUG:105, 152 
. BPT:82 

Aspect ratio. 

. GPT: 19 

ASSIGN 

Determining outcome of. 

. BIT:151 

I/O path names. 

.BIT:26 

Specifying attributes . . . . 

BIT: 139 

ASSIGN @. 

.BPT:223 

ATN. 

. BPT:82 

Attributes 

Assigning. 

. BIT: 139 

BYTE. 

. BIT:141 

CONVERT. 

. BIT:146 

EOL. 

.BIT:148 

FORMAT OFF. 

.BIT:139, 33 

FORMAT ON. 

. BIT:137, 33 

PARITY. 

. BIT: 149 

RETURN . 

BIT: 151 

WORD. 

BIT: 142 

Auto Line Numbering. 

BPT:7 

Auto shutter, 3V2-inch disc. 

. BUG:17 

AUTOST. 

.BPT:35 

Autostart on SRM. 

.BPT:36 

Autostart program. 

. BPT:35 

AXES. 

BUG:134,136,142 
. BPT:336 

GPT:10, 11, 28, 29, 30, 33 


BPT: BASIC Programming Techniques 
BIT: BASIC Interfacing Techniques 
GPT: BASIC Graphics Programming Techniques 
BUG: BASIC User’s Guide 
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BACK SPACE key, HP 98203A.BUG:78 

BACK SPACE key, HP 98203B.BUG:65 

Backgrounds. GPT:93 

Backplane. BIT:6 

Backspace key, HP 46020A.BUG:48 

BASE. BPT:82, 91 

Base Conversion. BPT:138 

BASIC 2.0. BPT:379 

BASIC 2.0/2.1. BUG:137 

BASIC 3.0 documentation.BUG:155 


BASIC 3.0 Drivers Disc 

... BUG:30,31,32,105,127,128,129,132,133 
BASIC 3.0 Language Extensions Disc 

. BUG:30,31,127,128,130,133 

BASIC 3.0 Manual Examples Disc 
. BUG:111,113,117,123 


BASIC 3.0 System Disc 

BUG:25,26,27,28,29,30,127,129,132,136,153 

BASIC description. BUG: 1,6 

BASIC discs.BUG:13 

BASIC programming. BUG:87,151 

BASIC, booting. BUG:7,10,25,143 

BASIC, loading. BUG:5 


BCD 

BIN file. BUG:129 

Binary mode. BIT:405, 416 

Configuration. BIT:408 

Data representations.BIT:402 

ENABLE INTR.BIT:427 

ENTER. BIT:403, 413 

Handshakes. BIT:410 

Installation note. BIT:401 

Interface description. BIT:402 

Interrupts.BIT:427 

ON INTR. BIT:427 

Optional format. BIT:404, 420 

OUTPUT. BIT:407, 423 

Register summary. BIT:428 

Reset. BIT:412 

Service routines.BIT:427 

Standard format.BIT:403, 414 

Timeouts. BIT:425 

BDAT Files.BPT:203 

BUG:106 

Reading.BPT:225 

Writing. BPT:225 

Benchmarking.BPT:319 


BIN files.BUG:30,105,127,128,129,142 


BINAND. BPT:82 

Binary Tree. BPT:186 

BINCMP. BPT:82 

BINEOR. BPT:82 

BINIOR.BPT:82 

BINs. BPT:37 

Deleting from Memory. BPT:43 

Loading.BPT:37 

Scratching. BPT:37, 43 

BIT. BPT:82 

Bits and bytes.BIT:11 

Bits/pixel. GPT:39 

Blank Lines. BPT:283 

Boolean Arrays. BPT:98 

Boot ROM. BUG:7,143 

Boot ROMs, earlier.BUG:7,8,135,143 

Boot ROMs, later.BUG:7,135,143 

Booting BASIC.BUG:7,10,25,143 

Boundary Conditions. BPT:300 

Boxing the Screen. BPT:333 

Break 

Command. BIT:141 

Datacomm. BIT:272 

Serial. BIT:331 

Break key, HP 46020A.BUG:52 

BUBBLE. BPT:212 

BUBBLE BIN file. BUG:129 

Bubble Memory. BPT:220 

Buffers 

Assigning I/O path names.BIT:169 

Creating. BIT: 169 

Description. BIT:168 

Pointers. BIT:170, 193 

Registers. BIT:195 

Bugs.BPT:299, 307 

Bus.BIT:6 

Bus sequences.BIT:202 

Business colors. GPT:84 

BYTE attribute. BIT:141 


BFT: BASIC Programming Techniques 
BIT: BASIC Interfacing Techniques 
GPT: BASIC Graphics Programming Techniques 
BUG: BASIC User’s Guide 
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C I/O key, HP 98203A. BUG:84 

Calculating. BUG:125 

CALL. BPT:169 

BIT:162 

Calling a Subprogram. BPT:169 

Caps key, HP 46020A. BUG:45 

CAPS key, HP 98203A. BUG:76 

CAPS LOCK key, HP 98203B. BUG:62 

CASE. BPT:57 

Case Conversion. BPT:130 

CAT statement. BPT:27, 246 

BUG:105,108,118,146 

Catalog Header, Suppressing. BPT:250 

Cataloging the Disc. BPT:247 

Cataloging, Skipping Files. BPT:251 

Ceiling of a number. GPT:6 

CHANGE. BPT:22 

Changing CRT Hz setting. BUG:10 

Changing program variables.BUG:126 

Chapter preview. BIT:2 

Character 

Code. BUG:119 

Height. BPT:337 

Width.BPT:337 

Character Set, Extended. BPT:143 

Character Set, Highlights.BPT:143 

Character-cell.GPT:18 

Choosing colors. GPT:100 

CHR$ function. BPT:127 

BUG:120,121,122,148 

Clear display key, HP 46020A. BUG:51 

Clear line key, HP 46020A. BUG:51 

Clearing 

Memory. BUG:151 

the Computer. BPT:43 

the CRT. BPT:282 

CLIP. BPT:339, 

GPT:34 

CLIP OFF. GPT:29, 34 

CLIP ON.GPT:29, 34 

Clipping. BPT:338 

GPT:29, 34, 8 

Clock. BPT:265 

Accuracy. BPT:275 

Events. BPT:276 

Setting. BPT:268, 270 

CLOCK BIN file. BUG:130 


Closed loop system. GPT:71 

Closing an I/O Path.BPT:223 

CLR I/O. BPT:314 

CLR I/O Key. BPT:17 

BIT:97 

CLR I/O key, HP 98203B. BUG:73 

CLR L key, HP 98203A.BUG:81 

CLR LN key, HP 98203B. BUG:68 

CLR S key, HP 98203A. BUG:81 

CLR SCR key, HP 98203B. BUG:70 

CLR T key, HP 98203A. BUG:81 

CLR TAB key, HP 98203B. BUG:68 

Clr Tab softkey, HP 46020A.BUG:57 

CLR—>END key, HP 98203B. BUG:68 

CMY color cube. GPT:102 

Code, character. BUG:119 

COLOR. GPT:88 

Color. GPT:81 

Blindness.GPT:96 

Echoes. GPT:77 

Gamuts. GPT:106 

Graphics. BPT:347 

Lines. BPT:349 

Map. GPT:85 

Map animation.GPT:96 

Spaces. GPT:102 

Temperature. GPT:101 

Colors 

Business. GPT:84 

Default. GPT:84 

Primary.GPT:84 

COM. BPT:32, 120 

COM Blocks. BPT:173 

Command.BPT:6 

Comments. BPT:11,13, 317 

Common. BPT:316 

Common and GET.BPT:34 

Comparing REAL Numbers. BPT:301 

Comparision Operators. BPT:79 

Compatibility with 9845 graphics. . . . GPT:129 

Complementary writing. GPT:94 

Computer backplane. BIT:6 

Computer installation.BUG:1 

Computer resource.BIT:5 

Computing range.BUG:95 

Concatenation, Strings. BPT:121 


BPT: BASIC Programming Techniques 
BIT: BASIC Interfacing Techniques 
GPT: BASIC Graphics Programming Techniques 
BUG: BASIC User’s Guide 




























































































10 


Conditional 

Branching. BPT:53 

Execution. BPT:51 

Configuration, CRT. BUG:148 

Configuring a System. BPT:37 

Configuring BASIC. BUG:134,153 

Constants. BPT:325 

CONT key, HP 98203A. BUG:83 

Context Switching. BPT:176 

CONTINUE. BPT:47 

CONTINUE key, HP 98203B. BUG:73 

Continue softkey, HP 46020A.BUG:56 

Continuous degrees of freedom.GPT:73 

Contour plotting. GPT:116 

CONTROL. BPT:283 

Control Characters. BPT:257 

Displaying. BPT:140 

CONTROL statement. BIT:75 

Control-C key. BUG:10 

Controlling pen force. GPT:67 

Controlling pen speed. GPT:67 

Conversions 

BY INDEX. BIT:146 

BY PAIRS. BIT:146 

Using string variable. BIT:385 

CONVERT Attribute.BIT:146 

COPY statement. BPT:38, 244 

BUG:35,36,106,107,145,149 

Copying 

Arrays. BPT:92 

Discs. BUG:35,36,145 

Files. BPT:38, 244 

BUG:106,149 

Program Segments. BPT:21 

Volumes. BPT:244 

COPYLINES. BPT:21 

COS. BPT:82 

CREATE ASCII. BPT:246 

CREATE BDAT. BPT:225 

Cross References. BPT:26 

CRT. BPT:82, 256 

Bit-mapped. BIT:98,102,105,106 

Clearing. BPT:282 

Configuration.BUG:144,148 

Control characters. BIT: 102 

Description. BIT:97 

Disabling the cursor.BIT: 112 

DISPline. BIT:111, 98 


Display functions mode. 

. BIT:103 

Enhancement characters 

. BIT:102,446 

ENTER. 

. BIT: 109 

Hz setting. 

. .. BUG:10,11,144 

Insert mode. 

. BIT:112 

Output. 

BIT:98 

Register summary. 

BIT:115 

Screen addresses. 

. BIT:106 

Screen width. 

.BIT:106 

Scrolling. 

.BIT: 107 

Size. 

.BPT:331, 341 

Softkey labels. 

.BIT:113 

CRTA BIN file. 

.BUG:129,132 

CRTB BIN file. 

.BUG:129,132 

CS80. 

. BPT:212 

CS80 BIN file. 

BUG:31,32,129,132 

CSIZE. 

. BPT:337 


GPT:16, 19, 23 

CSUBs. 

.BPT:379, 380 

CSUM. 

. BPT: 116 

CTRL key, HP 46020A .. 

.BUG:47 

CTRL key, HP 98203A .. 

. BUG:77 

CTRL key, HP 98203B . . 

. BUG:63 

Current relative location . . 

.GPT:47 


d 


DATA. 

. BPT:92, 194 

Data communications basics 

. BIT:257 

Data driven plotting. 

.GPT:43 

Data Files. 

. BPT:318 

Structure. 

. BPT:203 

Data Input. 

. BPT: 194 

Data Pointer, Moving. 

. BPT: 197 

Data representations 


ASCII characters. 

. BIT:12 

Design criteria. 

. BIT:152 

FORMAT OFF. 

. BIT:139 

FORMAT ON. 

.BIT:138 

In general. 

. BIT:11 

Numbers. 

. BIT: 12 

Real numbers. 

.BIT: 15 

Signed integers. 

. BIT:13 

Summary. 

. BIT:155 

Data Retrieval. 

. BPT:193 

Data Storage. 

BPT:193, 315, 316 

Data Structure. 

. BPT: 185 


BPT: BASIC Programming Techniques 
BIT: BASIC Interfacing Techniques 
GPT: BASIC Graphics Programming Techniques 
BUG: BASIC User’s Guide 
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Data Type Conversion. BPT:74 

Data Types, Numeric. BPT:73 

Datacomm 

Async diagram. BIT:258 

Async options. BIT:267 

Async protocol. BIT:258 

Block check. BIT:259 

Break. BIT:272 

Cable options. BIT:306 

Character frame. BIT:258,272 

Connections. BIT:264 

Control blocks. BIT:260 

Data link options. BIT:273 

Data link protocol. BIT:259 

Data messages. BIT:262 

Default settings. BIT:265 

Device identifier. BIT:259 

Error recovery. BIT:292 

Example programs. BIT:287,294 

Group identifier. BIT:259 

Handshakes. BIT:270,274 

Interrupt mask. BIT:279 

Interrupts. BIT:278 

Modems. BIT:275 

Normal mode.BIT:259 

Overview.BIT:263 

Parity. BIT:258,272 

Protocol selection.BIT:266 

Register summary.BIT:310 

Reset.BIT:266 

Service routines.BIT:281 

Start bit.BIT:258, 272 

Stop bit. BIT:272 

Stop bits. BIT:258 

Time gap. BIT:258, 272 

Timeouts. BIT:269 

Transparent mode.BIT:259 

DATE.BPT:82, 266 

DATES. BPT:265 

DCOMM BIN file. BUG:129 

Deactivating Events. BPT:69 

Debugging. BPT:307 

Declaring Arrays. BPT:74 

Declaring Variables. BPT:74 

DEF. BPT:168 

Default colors.GPT:84 

Default Dimensioning. BPT:119 

Default msus. BUG:149 

Default non-color map values.GPT:82 


Default printer. 

. BUG:150 

Defined Records. 

. BPT:225 

Defining a Viewport. 

.GPT:13 

Defining Softkeys. 

.BPT:39 

Degrees. 

. BPT:83 

Degrees of freedom. 

. GPT:72 

DEL C key, HP 98203A. . . . 

. BUG:81 

DEL CHR key, HP 98203B. 

. BUG:68 

DEL Command. 

.BPT: 10 

DEL L key, HP 98203A... . 

.BUG:80 

DEL LN key, HP 98203B . . 

.BUG:67 

Delete char key, HP 46020A 

. BUG:51 

Delete line key, HP 46020A 
Deleting 

. BUG:50 

BIN files. 

. BUG:142 

Lines. 

.BPT:10 

Subprograms. 

BPT:23, 181, 182 

DELSUB. 

. . . . BPT:23, 181 

Designing displays. 

. GPT:95 

Destination. 

.BIT:6 

Destination msus. 

. BUG:35 

DET. 

. . .. BPT:82, 111 

Determinant of a Matrix. 

. BPTrlll 

Device Selector. 

.. BUG:101, 108 

BPT:212, 253, 256 

Description. 

. BIT:23 

HP IB. 

.... BIT:199, 24 

Primary address. 

.... BIT: 199, 24 

Device Type. 

.BPT:211, 

BUG:100 

DIGITIZE. 

. BPT:355 

GPT:74 

Digitizing. 

.BPT:355 

DIM. 

. . . . BPT:120, 74 

Dimension Table. 

. BPT:315 

Dimensioning an Array. 

.BPT:85 

Directing data flow. 

.BIT:21 

Directories, Accessing. 

. BPT:246 

Directories, Reading. 

.BPT:246 

Directory listing.BUG:146, 104, 105 

Disabling Events. 

.BPT:69, 71 

Disc. 

BPT:0 

Cataloging. 

. BPT:247 

Copying. 

. BPT:244 

Directory. 

.BPT:201 

Initialization. 

.BPT:208 

Interleave. 

.BPT:200 

Labels. 

.BPT:209 

Structure. 

. BPT:198 


BPT: BASIC Programming Techniques 
BIT: BASIC Interfacing Techniques 
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DISC BIN file.BUG:31,32,129,132 

Disc Drives.BUG:100,101,102,103,104 

External. BPT:214 

Internal. BPT:214 

Discs 

flexible, 3V 2 -inch. BUG:14 

flexible, 5V4-inch. BUG:19 

flexible, backing up.BUG:14,19 

flexible, BASIC. BUG:13 

flexible, copying with one drive.... BUG:36 
flexible, copying with two drives ... BUG:35 

flexible, guard, 3Vfc-inch. BUG:14,17 

flexible, handling/use, 3 Vi-inch .... BUG:14 
flexible, handling/use, 5V4-inch .... BUG:19 

flexible, initializing. BUG:33,145 

flexible, inserting/removing 3 Vi-inch 

.BUG:17,18 

flexible, inserting/removing 5V4-inch 


. BUG:21 

flexible, part numbers. BUG:33 

flexible, storing.BUG:37 

flexible, temperature specs.BUG:15,20 

flexible, write-protecting. BUG:23 

24,146,147 

DISPLAY FCTNS key, HP 98203B . . BUG:69 
Display Fctns softkey, HP 46020A . . . BUG:58 
Display 

Configuration. BUG:144 

Enhancements.BUG:119,144,148 

Keyboard area.BUG:40,41 

Line.BUG:40,41 

Mechanical drawing. BUG:123 

Message/results line. BLJG:40,41 

Organization.BUG:40 

Shuttle.BUG:124 

Softkey labels.BUG:40,42 

Displaying Control Characters.BPT:140 

Displays.BPT:282 

Dithering.GPT:46 

Dithering color.GPT:89 

Dithering, optimizing.GPT:91 

Dominant pen mode.GPT:66 

DOT.BPT:82, 106 

Double Subscripted Substrings. BPT:123 

DRAW.BPT:332, 

GPT:50 


Drawing.. 
Arcs... 
Axes. . . 
Grids . . 
in Color 
Lines .. 


BPT:332 
GPT:123 
BPT:336 
BPT:336 
BPT:349 
. . GPT:4 


Modes. GPT:35 

Polygons.GPT:52 

Driver BIN files. BUG:129,133 

Drivers.BUG:30 

DROUND. BPT:81, 82, 84 

DUMP ALPHA key, HP 98203B .... BUG:70 
DUMP ALPHA statement.. BUG:112,113,150 


DUMP DEVICE IS. BPT:344 

GPT:62, 63 
BUG:112,113,150 

DUMP GRAPHICS. GPT:62, 63 

BUG:112,113,150 
DUMP GRAPHICS key, HP 98203B 


.BUG:70 

Dumping raster images.GPT:62 

Dumping to a printer.BUG:112 

DVAL. BPT:82, 138 

DVAL$.BPT:138 

Dyadic Operators.BPT:79 



Earlier boot ROMs ... 

EDGE. 

Edit. 

EDIT KEY. 

EDIT key, HP 98203B 
Edit Mode, Exiting ... 
EDIT statement 


BUG:7,8,135,143 

.GPT:50, 56 

. BPT:7 

.BPT:39 

.... BUG:66, 69 
.BPT:14 


BUG:48,50,63,65,77,78,80,87,89,124,125,151 


Editing 

Programs.BUG:151,89 

Softkeys.BPT:39 

Subprograms. BPT:182 

Editor.BPT:7 

Efficiency of programs.GPT:128 


BPT: BASIC Programming Techniques 
BIT: BASIC Interfacing Techniques 
GPT: BASIC Graphics Programming Techniques 
BUG: BASIC User’s Guide 
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ENABLE INTR 

BCD. BIT:427 

Datacomm. BIT:279 

General. BIT:93 

GPIO. BIT:386 

HP-IB. BIT:207 

Enabling Events. BPT:66 

BIT:92 

end. BPT:46 

With datacomm interface. BIT:41, 54 

With free-field OUTPUT. BIT:40 

With HP-IB. BIT:53 

With HP-IB interface. BIT:41 

With OUTPUT USING. BIT:52 

END IF. BPT:54 

END LOOP. BPT:64 

END WHILE. BPT:62 

End-of-File. BPT:240 

End-Of-File Pointers. BPT:228 

End-of-Record. BPT:240 

Ending Functions. BPT:183 

Ending Subprograms. BPT:183 

Enhancement characters. BIT:104 


Enhancements, display. . . . BUG:119,144,148 


ENTER. 

BCD. 

Buffers. 

CRT. 

Datacomm. 

Destination items. . 
EOI termination... 
Example statement 

Free-field. 

From files. 

GPIO. 

HP-IB. 

Keyboard . 

Nested images 

Numeric data. 

Re-use. 

Repeat factors .... 

Serial. 

String data. 

String variables ... 

Termination. 

Using images. 

Enter key. 

HP 46020A. 

HP 98203A. 

HP 98203B. 


. BPT:6, 238 

. BIT:403, 413 

.... BIT:167, 175, 185 

. BIT:110 

. BIT:263 

.BIT:20 

.BIT:62, 70 

. BIT:19 

BIT:55 

. BIT:154 

. BIT:381 

BIT:200, 202, 217, 225 
BIT: 122 

. BIT:72 

.BIT:56 

.BIT:72 

. BIT:72 

.BIT:328 

. BIT:60 

. BIT:159, 22 

. BIT:62, 70 

BIT:64 

. BUG:11 

. BUG:46,49 

.BUG:76 

. BUG:62 


Entering 

a Single Item. BPT:293 

Data. BIT:55 

Program Lines. BPT:8 

EOF Pointers. BPT:228 

EOL sequence. BIT:148, 39 

EPROM. BIT:435 

BPT:212 

BIN file.BUG:129 

Initializing.BIT:440 

Media. BIT:437 

Memory.BIT:436 

Memory address. BIT:438 

Memory card. BIT.-435 

Programmer card.BIT:435 

Programming. BIT:441 

Select code.BIT:437 

Storing data.BIT:442 

Storing programs. BIT:445 

Erasing colors. GPT:83 

ERR BIN file.BUG:30,31,32,96,130,132 

ERRL. BPT:302 

ERRM$. BPT:302 

ERRN. BPT:302 

Error 

Correction. BUG:26,27,29 

Detection. GPT:69 

Messages. BPT:383 

Messages, keyboard. BUG:96 

Numbers. BPT:302 

Trapping. BPT:302 

Self-test. BUG:11 

Error Recovery 

Datacomm interface. BIT:292 

Serial interface.BIT:330 

Errors.BPT:299, 383 

Operator.BPT:300 

Program.BUG:97 

Escape Code Sequences. BPT:258 

European characters. BIT:457 

Event-Initiated Branching. BPT:45, 66 

Events. BPT:66 

Deactivating.BPT:69 

Disabling.BPT:69 

Enabling.BPT:66 

EXEC. BPT:6 

EXECUTE.BPT:6 

Executing a Subprogram.BPT:169 

EXIT IF. BPT:64 

Exiting Edit Mode.BPT:14 


BPT: BASIC Programming Techniques 
BIT: BASIC Interfacing Techniques 
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EXP. BPT:82 

Expressions, Evaluating. BPT:77 

Extend char. BIT:118 

Extend char key, HP 46020A.BUG:46 

Extended Character Set. BPT:143 

Extended character set, HP 46020A. . BUG:46 

External color displays. GPT:65 

External devices 

Disc Drives. BPT:214 

General. BIT:5, 23 

Printers. BPT:257 


f 


FHPIB BIN file. 

. BUG:129 

Field specifiers. 

. BIT:42. 64 

File 


Accessing. 

. BIT:152 


BPT:222 

ASCII. 

. BIT:154, 157 


BPT:206 

BDAT. 

.BIT:153, 164 


BPT:203 

Copying. 

. BPT:38,244 


BUG:106,149 

Data. 

. BPT:318 

Definition of BIN. 

. BUG:30 

Loading BIN. 

.BUG:30 

Names. 

. BPT:28, 202 

Opening. 

. BPT:222 

Plotting to. 

. BPT:346 

Program. 

.BPT:318 

Protecting. 

.BPT:38, 242 

Purging. 

. BPT:38, 245 

Renaming. 

. BPT:38 

Types. 

. BPT:202 


BUG:105,106 

FILL. 

. GPT:50, 56 

FIND. 

. BPT:21 

Firmware. 

.BIT:5, 16 

Flexible discs (see Discs, 

flexible) 

Floor of a number. 

.GPT:6 

FN. 

. BPT:168 

FNEND . 

. BPT:183 

FOR NEXT. 

. BPT:59 

FORMAT OFF. 

.BIT:139 

FORMAT ON. 

. B1T:137 

Formatted Printing. 

. BPT:259 


FRACT.BPT:82 

FRAME. BPT:333 

Frame buffer. GPT:83 

Free-field convention. BIT:35 

Function or Subprogram. BPT:167 

Functions 

Ending. BPT:183 

String. BPT:125, 129 

User-Defined. BPT:165 


g 


GCLEAR statement. 

. BUG:118 

GDUs. 

. BPT:333. 


GPT:8, 13, 19 

GESCAPE . 

.GPT:77, 88 

GET. 

. BPT-.30 


BUG:105,151 

GINIT. 

.. . BPT:332, 342, 


GPT-.4 

GLOAD. 

. BPT:341 

GOSUB. 

. BPT:48 

GOTO. 

BPT:48 

GPIO 


BIN file. 

.BUG:129 

Byte mode. 

. B1T:378 

Configuration. 

. BIT:364 

Control lines. 

. BIT:393 

Data representations . . . . 

. B1T:378, 383 

Description. 

.B1T:364 

ENTER. 

. B1T:381 

Example programs. 

. B1T:389 

Handshakes. 

. BIT:366 

Installation. 

.BIT:363 

Interrupts. 

. B1T:386 

ON INTR. 

. BIT:386 

OUTPUT . 

. B1T:380 

PSTS line. 

. BIT:394 

READIO and WRITEIO . 

.BIT:397 

Register summary. 

. BIT:395 

Reset. 

.BIT:377 

Service routines. 

. BIT:387 

Status lines. 

. B1T:393 

Timeouts. 

. B1T:381 

Word mode. 

. B1T:380 

GRAPH BIN file. 

BUG:112,117,130 

Graphic Display Units. 

.... BPT:333, 336 


BPT: BASIC Programming Techniques 
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Graphic Units. BPT:336, 340 

Graphics. BPT:331 

Color. BPT:347 

Initializing. BPT:332, 342 

Interactive. BPT:354 

Monitors. BPT:331 

Output Devices. BPT:342 

Saving an Image. BPT:341 

Storing. BPT:351 

Graphics input. GPT:79 

GRAPHICS INPUT IS. GPT:80 

GRAPHICS Key.BPT:331 

GRAPHICS key, HP 98203B . . . BUG:69,116 

GRAPHICS OFF. BPT:283, 331 

BUG:116,117 

GRAPHICS ON. BPT:331 

GPT:4 

BUG:116,118 


Graphics/Dump Graphics key, HP 46020A 

. BUG:54,116 

GRAPHX BIN file. BUG:130 

GRID. BPT:336 

GPT:28, 30, 33 

GSTORE. BPT:341 

GSTORed image. GPT:64 

Guide organization. BUG:2 



Halting Program Execution. BPT:46 

Handshakes 

BCD. BIT:410 

Datacomm. BIT:270, 274 

GPIO. BIT:366 

HP-IB.BIT:233 

In general.BIT:17 

Serial. BIT:328 

Hard Clip Limits. BPT:338 

GPT:8, 34 

Hardware. BIT:5 

BPT:382 

Hardware priority.BIT:89 

Hewlett-Packard Graphics Language 

. GPT:61, 67 

Hierarchy. BPT:121 

Arithmetic. BUG:93,141 

Numeric Operating. BPT:77 


Highlight Characters. BPT:143 

Housekeeping. GPT:125 

HP 46020A Keyboard. BUG:39,43 

HP 46060A Mouse. BUG:40 

HP 82901 Disc Drive. BUG:129 

HP 82902 Disc Drive. BUG:129 

HP 8290X Disc Drive. BUG:129 

HP 9135 Disc Drive. BUG:129 

HP 98203A Keyboard. BUG:39,75 

HP 98203B Keyboard. BUG:39,61 

HP 98255 EPROM interface. BUG:129 

HP 98259 Magnetic Memory interface BUG:129 

HP 98622 GPIO interface. BUG:129 

HP 98623 BCD interface. BUG:129 

HP 98624 HP-IB interface. BUG:129 

HP 98625 High-speed Disc interface BUG:129 
HP 98626 Asynchronous Serial Interface 

. BUG:129 

HP 98628 Datacomm interface.BUG:129 

HP 98629 Shared Resource Management 

interface. BUG:129,131 

HP 9885 Disc Drive. BUG:129 

HP-IB 

ABORT statement.BIT:207 

Active Controller.BIT:201 

Advanced bus management.BIT:211 

ATN.BIT:202, 234 

Bus.BIT:197 

Bus commands and codes. BIT:213 

Buslines. BIT:236 

Bus messages. BIT:211 

CLEAR statement.BIT:206 

Commands. BIT:202 

Control lines.BIT:233 

Controller status and address.BIT:219 

DAV.BIT:233 

ENABLE INTR.BIT:207 

EOI.BIT:234 

Example bus sequences.BIT:202 

General structure. BIT:201 

Handshake lines.BIT:233 

Handshakes.BIT:233 

IFC. BIT:234 

Interface.BIT:197 

Interface status.BIT:229 

Interrupt registers.BIT:222 

Interrupts.BIT:207, 221 

Listen addresses.BIT:214 

Listener. BIT:201, 202 
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LOCAL statement. BIT:205 

Message mnemonics. BIT:217 

Multiple listeners. BIT:203 

NDAC. BIT:233 

NDAC holdoff. BIT:232 

Non-Active Controllers. BIT:219 

NRFD. BIT:233 

ON INTR. BIT:207, 221 

Pass control command.BIT:216, 220 

PPOLL statement. BIT:209 

Primary address. BIT:24, 199 

Register summary. BIT:237 

REMOTE statement. BIT:204 

REN. BIT:234 

Secondary addressing. BIT:203 

Secondary commands . . BIT:216, 222, 231 

Sending data. BIT:217 

SPOLL statement. BIT:210 

SRQ. BIT:234 

Statement summary. BIT:204 

System controller. BIT:201 

Talk addresses. BIT:214 

Talker. BIT:201, 202 

TRIGGER statement. BIT:206 

Unlisten . . . . BIT:202 

Unlisten command. BIT:214 

Untalk command.BIT:214 

HP9885 BIN file. BUG:129 

HPGL. BPT:345, 

GPT:61, 62, 67 

HPGL plotter speeds. GPT:130 

HP1B BIN file. BUG:32,129,132 

HSL color space.GPT:104 

HSL Model.GPT:86 

HSL Resolution. GPT:87 

Human interface. BUG:6 

Hz setting, CRT. BUG:10,11,144 


i 


I/O 

Backplane. 

Buffers. 

Description. . . . 

Examples. 

Statements 
String variables 


BIT:6 

. . . BIT:169 
BIT:6, 16 

BIT:18 
BIT:16 
BIT:22, 155 


I/O Path. BPT:222 

Closing. BPT:223 

Opening. BPT:222 

I/O Path Names 

ASCII files. BIT:154 

Assigning. BIT:26 

Attributes. BIT:33, 137 

BDAT files. BIT:153 

Benefits of using. BIT:31 

Buffers. BIT: 169 

Closing. BIT:28 

Data type. BIT:27 

Description. BIT:25 

In COM. BIT:31 

Local. BIT:29 

Pass parameters. BIT:30 

Re-assigning. BIT:28 

Register summary. BIT:79 

Table. BIT:27, 76 

Identifiers. BPT:317 

Identifying keyboard. BUG:9,39 

Identity Matrix. BPT:107 

IDN. BPT:107 

IDRAW. BPT:334 

IF THEN. BPT:51 

IF THEN ELSE. BPT:55 

Ill-Conditioned Matrices.BPT:112 

IMAGE.BPT:260 

Image.GPT:64 

Image Specifiers, Numeric.BPT:261 

Image Specifiers, String. BPT:262 

Images. BPT:260 

Binary. BIT:47, 69 

ENTER definitions.BIT:64 

Nested. BIT:52, 72 

Numeric.BIT:44, 66 

OUTPUT definitions.BIT:44 

Re-use.BIT:51, 72 

Repeat factors.BIT:50, 72 

Special.BIT:48, 68 

Specifiers. BIT:42, 64 

String.BIT:46, 67 

Termination. BIT:49, 71 

IMOVE. BPT:334, 

GPT:50 

Implicit Dimensioning.BPT:90 

Incremental Moves. BPT:334 

Incremental plotting. GPT:50 

INDENT. BPT:23 


BPT: BASIC Programming Techniques 
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Indenting a Program. BPT:23 

INDEX Conversions. BIT:146 

INITIALIZE statement 

. BUG:34,36,107,145,146 

Initializing a Disc. BPT:208 

Initializing flexible discs. BUG:33,145 

Initializing Graphics. BPT:332, 342 

INPUT Statement. BIT:122 

Inputting 

Data. BIT:155 

Multiple Fields. BPT:296 

INS C key, HP 98203A. BUG:80 

INS CHR key, HP 98203B. BUG:67 

INS L key, HP 98203A. BUG:79 

INS LN key, HP 98203B. BUG:67 

Insert char key, HP 46020A. BUG:50 

INSERT LINE Key. BPT:9 

Insert line key, HP 46020A. BUG:50 

Inserting 

3V2-inch disc. BUG: 17,18 

SVi-inch disc. BUG:22 

Lines. BPT:9 

Subprograms. BPT:182 

Installation, computer. BUG:1 

INT. BPT:82 

INTEGER. BPT:73 

Numbers. BPT:204 

Internal representation. BIT: 13 

Variables. BPT:321 

With FORMAT OFF attribute.BIT:140 

INTENSITY. GPT:86 

Interactive Graphics. BPT:353 

GPT:71 

Interface select code. BIT:23 

Interface, human. BUG:6 

Interfaces 

Concepts. BIT:5 

Events. BIT:81 

Function of. BIT:7 

Interrupts.BIT:91 

Overview. BIT:9 

Select code table. BIT:23, 451 

Timeouts. BIT:96 

Interleave on Discs. BPT:200 

INTERNAL. BPT:212 

Internal 

Disc Drives. BPT:214 

Format for files. BIT:140 

Numeric Formats. BPT:75 


BIT:12, 13, 15 


Interrupts 

BCD. BIT:427 

Conditions. BIT:95 

Datacomm. BIT:279 

Enabling. BIT:91 

GPIO. BIT:386 

Hardware priority. BIT:87 

HP-IB. BIT:221 

HP-IB (Non-Active Controller) .... BIT:221 

HP-IB (registers). BIT:222 

HP-IB (SRQ). BIT:207 

Mask. BIT:92 

Overview. BIT:91 

Re-enabling. BIT:93 

Software priority. BIT:84 

Interval Timing. BPT:274 

Introduction. BPT:1 

INV. BPT:108 

Inverse Matrix. BPT:107 

10 BIN file. BUG:130 

IPLOT. BPT:334, GPT:50, 56 

Isotropic. GPT:5, 13 

Scaling.GPT:5 

View. BPT:340 

Item separators. BIT:36, 56 

Item terminators. BIT:36, 56 

IVAL. BPT:82 


J 

Jumper, CRT Hz.BUG:11 

k 


Katakana characters. BIT:440 

HP 46020A. BUG:46 

KBD. BPT:39, 82, 256 

KBD BIN file. BUG:72,85,131 

KBD$ function. BIT:130 

Key sequences, non-ASCII.BIT:124, 446 

Keyboard 

Auto-repeat. BIT: 121 

Buffer size. BIT:130 

CAPS LOCK mode. BIT:120 

Closure keys. BIT: 126 

Control characters. BIT:119 
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Description. 

.BIT:117 

Lexical Order. 

. BPT: 139 

Disabling. 

.BIT: 132 

Predefined. 

. BPT:145 

Display area. 

.. BUG:40,41 

User-Defined. 

. BPT:156 

Enhanced control. 

.BIT:130 

LEXICAL ORDER IS. 

. BPT:130, 139 

ENTER. 

.BIT:122 

Lexical Tables. 

. BPT:146 

Error messages. 

BUG:96 

LEX-AID. 

. BPT: 158 

Functional key groups. 

.BIT:118 

LGT. 

.BPT:82 

identification. 

. .. BUG:9,39 

LIF ASCII files. 

.BIT:154 

Input. 

.... BPT:292 

Line Rotation. 

.BPT:335 

Key sequences tables. 

.BIT:446 

LINE TYPE. 

. BPT:337 

Knob. 

BIT: 129, 132 


GPT:38, 39 

Lock out. 

BIT: 132, 134 

Linear Program Flow . 

. BPT:45, 46 

OUTPUT . 

.BIT:124 

LINPUT. 

.BPT:296 

PRINTALL mode. 

.BIT:120 

LIST BIN statement . . 

. BUG:132,142 

Register summary. 

.BIT:135 

LIST KEY. 

.BPT:41 

Simulated EOI. 

.BIT:123 

LIST statement. 

... BUG:89,90,111,151 

Trapping keystrokes. 

.BIT:130 


BPT:11 

Trapping softkeys and KNOB 

.BIT:132 

Listing 


Keyboards. 

. BPT:8 

BIN files. 

. BUG:142 

Keys, special. 

BUG:9 

Disc’s directory . . . . 

.... BUG:104,105,146 

Keyword. 

. BPT:5 

Program. 

. BPT:11 


BUG:1 


BUG:151 

Knob applications. 

.BIT:129 

SRM directory. 

. BUG:106 

Knob, Using. 

. BPT:68 

Live Keyboard. 

.BPT:16, 308 

KNOBX function. 

. BIT: 128,129 

LOAD. 

. BPT:28, 34 


BPT:69 

BUG:90,105,111,113,115,117,123,124,151 

KNOBY function. 

. BIT:128,129 

LOAD BIN statement 



BPT:69, 380 


BUG:105,133,134,142 


1 

LABEL. BPT:337 

GPT:9, 16, 23 

Label Location. BPT:337 

Labeling a PLOT.GPT:9 

Labels, Disc. BPT:209 

Language extensions. BUG:30 

Language extensions BIN files. . BUG:130,133 

Language, machine. BUG:7 

Later boot ROMs. BUG:7,135,143 

LDIR. BPT:337, 

GPT:21, 22, 23 

LEN.BPT:125 

Length of a String. BPT:119, 125 

Length, Header of BDAT-file strings. . BIT:140 
LEX BIN file. BUG:131 


LOAD KEY.BPT:41 

Loading 

BASIC.BUG:5 

BIN files. BUG:30,142 

BINs. BPT:37 

Program. BUG:90,151 

Softkeys.BPT:41 

Subprograms.BPT:23, 180 

LOADSUB.BPT:23, 180 

LOADSUB ALL FROM.BIT:165 

LOG.BPT:83 

Logic levels. BIT: 11 

Logical Comparisions. BPT:326 

LOOP.BPT:59, 63 

Loop Counter. BPT:60 

Loops.BPT:322 

LORG. BPT:337 

GPT:20, 21, 22, 23 
LWC$.BPT:130 
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Machine language. BUG:7 

Main Program. BPT:5 

Major tick count. GPT:31 

Major tick lines. GPT:32 

Manual Examples disc. GPT:1 

Manual shutter, 3y2-inch disc. BUG: 17 

Manual, Overview. BIT:1 

Mapped. GPT:13 

Mapping. BPT:356 

Mass Memory Performance.BPT:318 

Mass Storage. BPT:198 

As an I/O resource. BIT:21 

File access. BIT:152, 157, 164 

Non-Disc. BPT:220 

Mass Storage Access. BPT:210 

MASS STORAGE IS statement.BPT:214 


BUG:107,113,115,149 
Mass Storage Unit Specifier (see msus) 


MAT. BPT:93 

MAT BIN file. BUG:131 

MAT Functions. BPT:132 

MAT REORDER. BPT:99 

GPT:97 

MAT SORT. BPTilOO 

Math Hierarchy. BPT:77 

Mathematical Operations. BPT:321 

Matrix. BPT:103 

Determinant. BPTilll 

Identity. BPT:107 

Ill-Conditioned. BPT:112 

Inverse. BPT:107 

Multiplication. BPT:103 

Singular. BPT:110 

Summing Columns. BPT:116 

Summing Rows. BPT:116 

Transposition. BPT:115 

MAX. BPT:83 

MAXREAL. BPT:83 

Mechanical drawing display. BUG: 123 

Media Specifiers. BPT:211 

MEMORY. BPT:212 


Memory 

Clearing. BUG:151 

Insufficient. BUG:27,29 

Saving. BPT:329 

Menu key, HP 46020A. BUG:55,56,153 


Menues.BPT:285 

Merging Subprograms. BPT:182 

Message/results line, display.BUG:40,41 

Micro-discs.BUG:14 

MIN. BPT:83 

Mini-discs. BUG:19 

Minor tick count. GPT:31 

Minor tick crosses. GPT:32 

Minor ticks. GPT:32 

MINREAL. BPT:83 

Mixed color modes. GPT:73 

Mixing colors. GPT:95 

Monadic Operators. BPT:79 

Monochrome echoes. GPT:76 

Mouse. BUG:40 

MOVE. BPT:332 


GPT:9, 23, 47, 50 

MOVELINES. BPT:20 

Moving 

Data Pointer.BPT:197 

EOF Pointers. BPT:228 

Pen. BPT:332 

Program Segments. BPT:20 

MS BIN file. BUG:131 

MSI statement.BUG:107,108,149 

MSUS. BPT:27, 211 

BUG:26,100,101,102,103,107,108,149 

msus, default. BUG:149 

Multiple Fields Input. BPT:296 

Multiple-systems booting. BUG:27 



Names 

I/O path.BIT:26 

Naming Files. BPT:28 

Naming Subprograms. BPT:165 

Nesting Structures. BPT:54 

Next key, HP 46020A. BUG:48 

Non-Active Controller. BIT:219 

Non-ASCII key sequences.BIT:124, 453 

Non-ASCII Keys. BPT:284, 393 

Non-ASCII Keystrokes. BPT:40 

Non-color mapped color. GPT:81 

Non-Disc Mass Storage. BPT:220 

Non-separable degrees of freedom . . . GPT:73 
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NPAR. 

. .. BPT:172 

Operators. 

. BPT:79 

Number Base Conversion. 

. . . BPT:138 

Comparision. 

.BPT:79 

Number builder. 

. BIT:56 

Dyadic. 

. BPT:79 

Numbers, Comparing. 

. . . BPT:301 

Monadic. 

.BPT:79 

Numeric 


OPTION BASE. 

. BPT:86 

Accuracy. 

BPT:76 

Optional Parameters . 

. BPT:171 

Computation. 

.... BPT:73 

Organization, guide. . 

. BUG:2 

Data Types. 

.... BPT-.73 

OUTPUT. 

. BPT:229, 230 

Formats, Internal. 

BPT:75 

ASCII files. 

. BIT:154, 157 

Functions. 

.... BPT:82 

BCD. 

. BIT:407, 423 

Image Specifiers. 

. . . BPT:261 

BDAT files. 

. B1T:153 

Precision. 

.... BPT:76 

Buffers. 

BIT:174, 182, 185, 188 

Numeric to String Conversion . . . 

.. . BPT:127 

CRT. 

. BIT:99 


O 

OFF KBD. BIT:130 

OFF-event.BPT:70 

ON CYCLE. BPT:66, 276 

ON DELAY.BPT:66, 276 

ON END. BPT:66, 240 

ONEOR. BPT:66 

ON EOT. BPT:66 

ON ERROR. BIT:330 

BPT:66, 302, 303 

ONINTR. BPT:66 

BCD. BIT:427 

Datacomm. BIT:279 

GPIO. BIT:386 

HP-IB.BIT:207, 221 

Powerfail.BIT:350 

ON KBD.BIT:130 

BPT:66 

ON KEY. BIT:82 

BPT:66, 67 

ON KNOB.BIT:128,132 

BPT:66, 68 

ON SIGNAL. BPT:66 

ON Statement. BPT:57 

ON TIME. BPT:66, 276 

ON TIMEOUT. BPT:66 

ON-event. BPT:66 

One-system booting.BUG:25 

Opening a File.BPT:222 

Opening an I/O Path.BPT:222 

Operator Errors. BPT:300 

Operator Hierarchy. BPT:77 


Datacomm. BIT:263 

Example statement. BIT:18 

Free-field. BIT:35 

GPIO. BIT:380 

HP-IB. B1T:200, 202, 215 

Keyboard. BIT:124 

Serial. B1T:328 

Source items.BIT: 18 

String variables.BIT:22, 155 

Using images. BIT:42 

Output area, display.BUG:40,41 

OUTPUT KBD.BPT:283 

Outputting data.BIT:35 

Overhead. BPT:315 


P 

PAIRS conversions. BIT:147 

Palette.GPT:85 

Parameters.BPT:170 

Parameters, Optional.BPT:171 

PARITY attribute.BIT:149 

PAUSE. BPT:47 

PAUSE Key. BPT:17 

PAUSE key, HP 98203B. BUG:73 

Pausing a Program. BPT:17 

Pausing system program search.BUG:11 

PDEV.BPT:20 

PDEV BIN file. BUG:131 

PDIR. GPT:47, 52 

PEN. BPT:332 

GPT-.81 

Pen Control. BPT:334 

Pen control parameter. GPT:43, 44 
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PEN number. 

.GPT:35 

PRINTER IS statement 


Pen, Moving. 

. BPT:332 

. BUG:109,110,111,115,150 

Pen, Moving Incremental . . . . 

. BPT:334 


BPT:254 

Performance. 

. BPT:318 

Printer Switch Setting. 

. BPT:254 

Peripherals. 

. BUG:99 

Printers. 

. BPT:253 

Photographing CRTs. 

. GPT: 107 

Control Characters. 

.BPT:257 

PHYREC . 

. . BPT:379, 381 

Escape Codes. 

. BPT:258 

PI. 

BPT:83 

External. 

.BPT:257 

PIVOT. 

. BPT:335 

Printing, Formatted. 

. BPT:259 


GPT:47, 52, 55 

Priority. 

. BIT:84 

Pixel. 

. GPT:46 

Problems/solutions. 

... BUG:26,27,29 

Pixels. 

. GPT:39 

PROG Files. 

. BPT:28 

PLOT. 

. BPT:332 


BUG:105,136,152 


GPT:4, 9 

Program 


PLOTTER IS. 

. BPT:342 

Counter. 

. BPT:45 


GPT:61 

Efficiency. 

. GPT: 128 

PLOTTER IS file. 

. BPT:346 

Execution. 

.BPT:15, 310 

Plotting contours. 

.GPT:116 

Execution, Selection. 

. BPT:51 

Plotting surfaces. 

.. GPT:116, 120 

Files. 

. BPT:318 

Plotting to a File. 

. BPT:346 

Program Flow 


POLYGON. 

. GPT:52 

Linear. 

. BPT:45 

POLYLINE. 

.... GPT:52, 55 

Repetition. 

. BPT:45 

Polynomial Evaluations. 

. BPT:325 

Selection. 

. BPT:45 

POS. 

. BPT: 125 

Sequence . 

.BPT:45 

Position of a Substring. 

. BPT:125 

Program Line. 

.BPT:5 

Powerfail. 

. BPT:275 

Programming. 

. BUG:87 

Clock . 

.BIT:349 

Programming a LOAD. 

. BPT:35 

Continuous memory. 

. BIT:349 

Programming GET. 

. BPT:31 

Interrupts. 

. BIT:350 

Programs 


Overview. 

. BIT:348 

Editing. 

. BUG:89,151 

Register summary. 

. BIT:359 

Errors. 

. BUG:97 

Service routines. 

. BIT:353 

Listing. 

.BUG:89,151 

Timers. 

. BIT:349 

Loading. 

. BUG:90,151 

Precision. 

. BPT:76 

Recording. 

. BPT:28 

Prerun. 

. BPT: 15 

Replacing. 

. BPT:29 

Prev key, HP 46020A. 

. BUG:48 

Retrieving. 

.BPT:27, 30 

Primary Address. 

.BPT:254 

Running. 

. BUG:88,152 


BIT:24, 199 

Search. 

. BUG:11 

Primary colors. 

.GPT:84 

Storing. 

. BPT:27 

PRINT. 

. BPT:259 


BUG:89, 152 

BUG:57,71,83,109,110 

System. 

BUG:5 

Print All softkey, HP 46020A. 

BUG:57 

Variables. 

. BUG:126 

Print key, HP 46020A. 

BUG:46 

Writing. 

. BUG:87 

PRINT USING. 

.BPT:260 

Prompts. 

. BPT:282 

PRINTALL IS. 

. . BPT:256, 313 

PROTECT. 

.BPT:38, 242 


BUG:110 

Protecting Files. 

.BPT:38, 242 

Printall printer. 

. BUG:110 

PROUND. 

. BPT:83, 84 

Printer. 

. . BUG:108,150 

PRT. 

.BPT:83, 256 

Default. 

. BUG:150 

PRT ALL key, HP 98203A 

. BUG:76,83 

Dumping to a. 

. BUG:112 

PRT ALL key, HP 98203B 

. BUG:71 


PSE key, HP 98203A. BUG:83 
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PURGE. BPT:38. 245 

Purging Files. BPT:38, 245 

Purpose of manual. BIT:1 


q 

Quantisizable degrees of freedom .... GPT:73 


r 


Radians. 

.BPT:83 

RAM Volumes. 

.... BPT:220 

Random ENTER. 

.... BPT:238 

Random Numbers. 

.BPT:84 

Random OUTPUT. 

.... BPT:234 

Range, computing. 

.BUG:95 

RANK. 

.BPT:83 

RATIO. 

.... BPT:336 
GPT: 14, 79 

RCL key, HP 98203A. 

.BUG:79 

RE-SAVE. 

.BPT:29 

RE-STORE. 

.BPT:29 

RE-STORE BIN. 

.... BPT:381 

RE-STORE KEY. 

.BPT:41 

READ. 

. BPT:92, 194 

READ LOCATOR. 

.... BPT:358 


GPT:74 

Reading 


BDAT Files. 

.... BPT:225 

Data From BDAT Files. 

.... BPT:237 

Directories. 

.... BPT:246 

REAL. 

.BPT:73 

FORMAT OFF representation 

.BIT: 140 

Internal representation. 

. BIT:15 

Number Comparisions. 

... BPT:301 

Real Numbers. 

BPT:204, 324 

Real-Time Clock. 

.... BPT:265 

Recall key, HP 46020A. 

BUG:53 

RECALL key, HP 98203B .... 

.BUG:66 

Recall softkey, HP 46020A .... 

.BUG:58 

Recalling Lines. 

.BPT:10 

Record Lengths. 

.... BPT:226 

Recording a Program. 

.BPT:28 

RECOVER . 

BPT:176 

RECTANGLE. 

.GPT:56 


Rectangles. GPT:56 

Recursion. BPT:184 

REDIM. BPT:95 

Redimensioning Arrays, Automatic . . . BPT:93 

Redimensioning Arrays, Explicit.BPT:95 

Register summary 

BCD. BIT:428 

Buffers. BIT:195 

CRT. BIT:115 

Datacomm. BIT:310 

GPIO.BIT:395 

HP-IB. BIT:237 

I/O path. BIT:79 

Keyboard. BIT:135 

Powerfail. BIT:359 

Serial. BIT:343 


Registers 

Access. BIT:73 

CONTROL. BIT:75 

Description. BIT: 16 

I/O path. BIT:76 

Interface. BIT:74 

READIO. BIT:79 

STATUS. BIT:74 

WRITEIO. BIT:79 

Relational Operations. BPT:121 

Relative Moves. BPT:335 

REM. BPT:12 

REMOTE. BPT:212 

Removing 3V2-inch disc. BUG:18 

Removing 5 Vi-inch disc. BUG:22 

REN Command. BPT:10 

RENAME. BPT:38 

Renaming a File. BPT:38 

Renumbering a Program. BPT:10 

Reordering Arrays. BPT:99, 135 

REPEAT UNTIL. BPT:59, 61 

Repeating a String. BPT:129 

Repetition. BPT:59 

Replacing Programs. BPT:29 

Requesting Service. BIT:226 

RES.BPT:83 

RESET Key. BPT:17 

Reset key. BUG:10 

Reset key, HP 46020A. BUG:52 

RESET key, HP 98203B.BUG:73 
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Reset 

BCD. BIT:412 

Buffers. BIT: 179 

Datacomm. BIT:266 

GPIO. BIT:377 

HP-IB. BIT:237 

Interface table. BIT:463 

Master table. BIT:459 

Serial. BIT:326, 343 

Resource 

I/O, definition of.BIT:5 

Specifying. BIT:16, 22 

Resources. BPT:315 

RESTORE. BPT:197 

Result key, HP 46020A. BUG:54 

RESULT key, HP 98203B. BUG:71 

Retrieving Programs. BPT:27, 30 

RETURN. BPT:48 

Return. BIT:118,122,123 

RETURN attribute. BIT: 151 

Return key, HP 46020A. BUG:45 

Returning from a Subprogram. BPT:49 

REVS. BPT:129 

Reversing a String. BPT:129 

RGB color cube. GPT:102 

RGB Model. GPT:86 

RND. BPT:83, 84 

ROM, boot. BUG:7 

Roman characters, HP 46020A.BUG:46 

ROMs, earlier boot. BUG:7,8,135,143 

ROMs, later boot. BUG:7,135,143 

Rotary pulse generator. BIT:129 

ROTATE. BPT:83 

Rotating Lines. BPT:335 

Rounding. BPT:84 

BUG:95 

Rounding Numbers. BPT:81 

RPLOT. BPT:335 

GPT:47, 48, 55, 56 

RPTS. BPT:129 

RS-232C 

Interface.BIT:321 

Interface cable.BIT:306, 337, 338 

List of signals. BIT:308, 341 

With datacomm.BIT:257 

RST key, HP 98203A. BUG:82 

RSUM. BPT:116 

RUN. BPT:15 

Run indicator. BUG:40,43 


RUN key, HP 98203A. BUG:83 

RUN key, HP 98203B. BUG:73 

Run Light. BPT:17 

RUN softkey, HP 46020A. BUG:56 

RUN statement. BUG:152 

Run-time. BPT:16 

Running a Program. BPT:15 


BUG:88,152 


s 

SAVE statement. BPT:28 

BUG:105,152 

Saving an Image. BPT:341 

Saving Memory. BPT:329 

Saving Time. BPT:327 

SC. BPT:83 

Scalar Expressions. BPT:77 

Scaling. GPT:5 

SCRATCH. BPT:43 

BUG:44,61,75,87,90,125,151 

SCRATCH A. BIT:113 

BPT:43 

SCRATCH BIN. BPT:43 

BUG:132,135,142 

SCRATCH C.BPT:43 

SCRATCH KEY.BPT:43 

Scratching BINs.BPT:37 

Screen Width. BPT:282 

BIT:108 

Search and Replace. BPT:21 

Search, pausing system program .... BUG:11 

Searching for Strings. BPT:136 

SECURE.BPT:243 

Securing Program Lines.BPT:243 

Seeing color.GPT:94 

SELECT.BPT:56 

SELECT CASE.BPT:57 

Select code table.BIT:23, 435 

Select key, HP 46020A. BUG:47 

Selecting 

Character sets. GPT:68 

Line types. GPT:38 

Plotter. GPT:61 

Self-test error. BUG:11 

Separable degrees of freedom. GPT:73 
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Serial 

Async. BIT:321 

Baud rates. BIT:325 

Character format. BIT:327 

Character frame. BIT:322 

Defaults. BIT:325 

ENTER. BIT:328 

BPT:237 

Error detection. BIT:329 

Error recovery. BIT:330 

Handshakes. BIT:328 

Modem handshake.BIT:328 

Modem-line switches. BIT:325 

OUTPUT. BPT:229, 

BIT:328 

Overview. BIT:324 

Parity bit. BIT:322, 327 

READIO and WRITEIO. BIT:332 

Register summary.BIT:343 

Reset. BIT:326 

Self-test. BIT:332 

Signal functions. BIT:337 

Special messages. BIT:331 

Start bit. BIT:321, 327 

Stop bit. BIT:322, 327 

UART. BIT:322 

SERIAL BIN file. BUG:129 

Service routines 

BCD. BIT:427 

Datacomm. BIT:281 

Example. BIT:82 

GPIO. BIT:387 

HP-IB. BIT:208, 221, 231 

Interrupts. BIT:91 

Logging. BIT:84,89 

Powerfail. BIT:353 

Serial. BIT:329 

Set-up. BIT:82,91 

Software priority. BIT:84 

System priority. BIT:86 

SET ECHO. BPT:358, 

GPT:74, 75 

SET PEN. GPT:86, 87, 97 

SET T key, HP 98203A. BUG:80 

SET TAB key, HP 98203B.BUG:68 

Set Tab softkey, HP 46020A.BUG:57 

SET TIME.BPT:268 

SETTIMEDATE. BPT:266 

Setting the Clock.BPT:268, 270 


Setting, CRT Hz. BUG:10 

SGN. BPT:83 

Shared Resource Management (see SRM) 

SHIFT. BPT:83 

Shift key, HP 46020A. BUG:45 

SHIFT key, HP 98203A. BUG:76 

SHIFT key, HP 98203B. BUG:62 

SHOW. BPT:340, 

GPT:5 

Shutter, 3V2-inch disc. BUG: 17 

Shuttle display. BUG:124 

Significant digits. BUG:95 

Simple Branching. BPT:48 

SIN. BPT:83 

Single Byte Access. BPT:239 

Single degree of freedom. GPT:72 

Single-Subscripted Substrings. BPT:122 

Singular Matrices. BPT:110 

SIZE. BPT:83, 91 

Soft clip area. GPT:8 

Soft Clip Limits.BPT:338 

GPT:8, 34 

Softkey 

Interrupts. BIT:84 

Labels. BIT:114 

Sensing with ON KNOB.BIT:132 

Softkey labels, display.BUG:40,42 

Softkeys. BIT:127,132 

BPT:39, 285 

Defining. BPT:42 

Definitions. BPT:39, 41 

Deleting from Memory. BPT:43 

Editing. BPT:39 

Files.BPT:41 

HP 46020A.BUG:55,153 

HP 98203A. BUG:85 

HP 98203B. BUG:72 

Listing. BPT:41 

Loading. BPT:41 

Software.BIT:5 


Software priority.BIT:84 

Solving Simultaneous Equations .... BPT:108 
Sorting 

Arrays.BPT:100 

by a Vector. BPT:134 

by Substrings. BPT:133 

Strings. BPT:131 

Source. BIT:6 


Source msus 


BUG:35 
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Special keys. 

. BUG:9 

Functions. 

BPT:125, 129 

SQR. 

. BPT:83 

Image Specifiers. 

.BPT:262 

SRM 


Length. 

BPT:119, 125 

Autostart. 

. BPT:36 

Relational Operations. 

.BPT:121 

BIN file. 

. BUG:129,131 

Repeat. 

. BPT:129 

Display. 

. BUG:117 

Reverse. 

. BPT:129 

Files. 

. BUG:106 

Sorting. 

. BPT:131 

Listing a directory. 

. BUG:117 

Storing. 

. BPT:120 

SRQ interrupts. 

. BIT:207 

Trimming. 

. BPT:129 

Standard numeric format. 

. BIT:36 

Stubbing subprograms. 

.BIT:163 

Standard string format. 

. BIT:36 

SUBEND. 

. BPT:183 

Statement. 

. BPT:5 

Subprogram or Function. 

.BPT:167 

Statements, New. 

.BPT:380 

Subprograms. 

. BIT:163 

STATUS statement. 

BIT:74 


BPT:5 

STEP Key. 

.BPT:310 

Calling. 

.BPT:169 

STEP key, HP 98203A. 

. BUG:82 

Deleting. 

.BPT:181 

STEP key, HP 98203B. 

.BUG:70 

Editing. 

.BPT:182 

Step softkey, HP 46020A. 

BUG:56 

Ending. 

.BPT:183 

Stepping. 

.BPT:310 

Executing. 

.BPT:169 

Stepwise refinement. 

. BIT:163 

Inserting. 

.BPT:182 

STOP. 

. BPT:46 

Libraries. 

. BPT:23, 180 

STOP Key. 

. BPT:17 

Loading. 

.BPT:180 

Stop key, HP 46020A. 

BUG:52 

Merging. 

.BPT:182 

STOP key, HP 98203A. 

. BUG:84 

Naming. 

.BPT:165 

STOP key, HP 98203B. 

BUG:73 

RECOVER . 

.BPT:177 

Stopping a Program. 

BPT:17 

Returning from. 

. BPT:49 

STORE KEY. 

BPT:41 

Softkeys. 

.BPT:177 

STORE statement. 

BPT:28 

Speed . 

.BPT:178 

BUG:89,105,136,137,142,152,153 

User-Defined. 

. BPT:165 

STORE SYSTEM statement . . 

. . BPT:37, 379 

Variables. 

.BPT:177 


BUG:134,153 

Substrings. 

.BPT:122 

Storing 


Double Subscripts. 

. BPT:123 

Data. 

.BPT:194 

Position. 

.BPT:125 

Data in Variables. 

.BPT:194 

Single Subscripts. 

. BPT:122 

Discs. 

BUG:37 

Sorting. 

. BPT:133 

Graphics. 

. BPT:351 

Subtractive color system. 

.GPT: 102 

Programs. 

.BPT:27 

SUM. 

. . . BPT:83, 94 


BUG:89,152 

Summing Columns in Arrays . . 

.BPT:116 

Strings. 

. BPT:120 

Summing Rows in Arrays. 

.BPT:116 

Systems. 

.BPT:37 

Suppressing a Catalog Header. 

..... BPT:250 

String to Numeric Conversion . 

.BPT:126 

Surface plotting. 

GPT: 116, 120 

String variables 


Switch, CRT Hz. 

BUG:11 

Buffers. 

. BIT:169 

Switching Context. 

.BPT:176 

I/O. 

. . BIT:22, 155 

SYMBOL. 

.. GPT:56, 57 

Strings. 

. . BPT:80, 119 

Symbol coordinate system. 

... GPT:19, 57 

Arrays. 

.BPT:120 

Symbol Table. 

. BPT:315 

Concatenation. 

.BPT:121 

Syntax. 

.BPT:9 

Default Dimensioning. 

.BPT:119 

Syntax Checking. 

. BPT:9 

Evaluation Hierarchy. 

BPT:121 

SYS system file prefix. 

BUG:135,153 
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SYSTEM. BIT:97,113 

System Configuration. BPT:37 

BUG:134 

System Controller.BIT:201 

System key, HP 46020A .... BUG:55,56,153 

System priority. BIT:86 

System program. BUG:5,39 

System program search. BUGrll 

System softkeys, HP 46020A. BUG:56 


SYSTEM$(“CRT ID”) statement 

. BUG: 119,144.148 

SYSTEMS(‘‘LEXICAL ORDER IS”) BPT:145 
SYSTEMS$(“KEYBOARD LANGUAGE”) 

.BPT:145 

Systems, Storing. BPT:37 

SYSTEM- system file prefix . . . BUG:135,153 

SYSTEM_BA3. BUG:127,129,135 

SYSTM files. BUG:106,135 


t 


TAB. BPT:259 

Tab key, HP 46020A. BUG:47 

TAB key, HP 98203A. BUG:77 

TAB key, HP 98203B. BUG:63 

TABXY.BPT:259 

TAN. BPT:83 


Temperature specs, flexible disc . . BUG:15,20 


Tick marks . . 

Time. 

TIME. 

TIMES. 

Time, Saving 
TIMEDATE.. 


.... GPT:11 
... BPT:265 
BPT:83, 266 
... BPT:265 
... BPT:329 
. . . BPT:265 


Timeouts 


BCD. BIT:425 

Datacomm. BIT:269 
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Introduction 


The Shared Resource Management (SRM) system allows several “workstation” computers to 
access shared mass storage and output devices (printers and plotters). This manual describes the 
use of HP Series 200 computers as SRM workstations. 

Both the BASIC and Pascal language systems support use of SRM. The Pascal system incorporates 
features to access shared resources, while a BASIC BIN file (SRM) accommodates access to SRM 
from the BASIC language .system. 

About Revision Numbers 

This manual contains references to the different versions of both the SRM operating system and of 
the BASIC and Pascal language systems supported on the HP Series 200 workstations. To clarify: 

• The most current version of the SRM operating system is version 2.0. This manual describes 
the use of this latest version of the SRM system. Information for users of version 1.0 is noted in 
the text where required. 

• SRM works with both BASIC 2.0 and BASIC 3.0. This manual describes the use of SRM with 
BASIC 3.0. The differences between uses of the two language system versions are summarized 
in the “SRM and BASIC 2.0” appendix. 

• SRM works with both Pascal 2.1 and Pascal 3.0. This manual’s descriptions of Pascal use with 
SRM applies to either version. 

Additional References 

If you are using your Pascal workstation for the first time, you should first read the Pascal User’s 
Guide and the Pascal Workstation System manual (previously the Pascal User’s Manual). 

If you are not already familiar with the BASIC language system, you should refer to the BASIC 
User’s Guide and other manuals shipped with that language system. This manual’s “BASIC Lan¬ 
guage Reference” section supplements, but does not replace information in the BASIC Language 
Reference manual. 
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This Manual’s Contents 

This manual consists of three chapters and three appendices: 

Chapter 1: HP Series 200 BASIC Workstation Use on SRM describes the use of HP Series 200 
computers operating under the BASIC language system. 

This chapter includes a conceptual overview of SRM, a tutorial demonstrating common uses of the 
workstation on SRM, and a language reference describing BASIC commands and statements that 
access shared resources. 

Chapter 2: HP Series 200 Pascal Workstation Use on SRM outlines the use of HP Series 200 
SRM workstations operating under the Pascal language system. 

This chapter includes a conceptual overview of Pascal features that accommodate SRM use and a 
section demonstrating common procedures you’ll need to use your SRM Pascal workstation. 

Chapter 3: System Startup describes the procedures required to bring up HP Series 200 worksta¬ 
tions on the SRM system for the first time. Presented for the SRM system manager, this chapter 
discusses recommended SRM directory structures for both BASIC and Pascal workstation use and 
describes installation of the BASIC or Pascal operating system software that allows workstations to 
access the SRM. 

Appendix A is a Glossary of SRM terms. 

Appendix B lists and describes SRM Interface STATUS Registers. 

Appendix C: SRM and BASIC 2.0 summarizes the differences between the use of BASIC 2.0 with 
SRM and the use of BASIC 3.0 with SRM. 







HP Series 200 BASIC 
Workstation Use on SRM 


Chapter 


This chapter describes the use of your HP Series 200 BASIC workstation with a Shared Resource 
Management system. The chapter is divided into four major sections: 

• The System Concepts section is an overview to help you understand how the SRM system 
works. 

• The Using Your BASIC Workstation on SRM section demonstrates, through the use of an 
example directory structure, some of the common operations involving shared resources. 

• The Modifying Existing Programs section discusses ways to change existing BASIC programs 
to make them work with SRM. 

• The BASIC Language Reference for HP Series 200 SRM Workstations section describes 
the use of BASIC commands and statements on SRM, including the special file and directory 
specification used with SRM. 


System Concepts 

This section presents a detailed look at some of the concepts of the SRM system, including 
descriptions of the following topics: 

• support of the BASIC language on SRM; 

• SRM directory structure and capabilities; 

• storing of remote directories and files; 

• shared access to directories and files (including file locking and password protection); 

• management of shared peripherals. 

Shared Resource Support of the BASIC Language 

With HP Series 200 workstations, you can use most BASIC statements that access local mass 
storage devices to access shared mass storage devices on SRM as well. Any changes to BASIC mass 
storage statements made by the SRM BIN file are described in the “BASIC Language Reference” 
section of this chapter. 

SRM adds three new commands to the BASIC mass storage statements used by HP Series 200 
computers - CREATE DIR, LOCK, and UNLOCK -and adds the PROTECT option for use with 
the CAT statement. In addition, the PROTECT statement’s use on SRM is distinct from its use with 
local files. 











SRM’s Hierarchical Directory Structure 

A directory is a file that is used to organize and control access to other files. The SRM operating 
system uses a hierarchical directory structure to organize and control access to files on a shared 
mass storage device. 

As the word “hierarchy” suggests, directories are arranged in a series of “graded levels.” Director¬ 
ies may contain either files or other directories. A file or directory within a directory is said to be 
“subordinate” to the containing directory. A directory is “superior” to the files and directories it 


contains. 



In the illustration above, the directory named KATHY is subordinate to the directory named 
Project-one, because Project-one contains the information describing KATHY. The directory 
named PROJECTS is at level 1, the “root” level. You cannot create a directory at a higher level 
than the root level. 

Each directory keeps information, in 24-byte fixed format records, about each file or directory 
immediately subordinate to it. 

Uses of the Hierarchy: An Example 

Suppose you’re managing several projects, each of which needs to access a shared disc. To 
organize the files for each project separately, you can create a directory for each project (as shown 
in the illustration). Within each project directory, you can have a subordinate directory for each 
person working on the project as well as files to be shared among all users. Each person may then 
construct a directory/file system for organizing their own files. 

Because files at different locations in the directory structure can have the same file name, you can 
use generic file names to identify similar project functions in the different projects. At the same time, 
the division into separate directories isolates the projects, and thus their individual functions, from 
one another. For example, ProjecLone’s budget file is distinct from Project_two’s budget file. 

Directories also limit the number of files users must deal with at any one time. For example, people 
working on Project—one (see illustration) need never see the files in Project—two and may, in fact, 
confine most of their activity to within their own directories. 

























































o ma ntain security, SRM provides the capability to protect access to directories and files. For 
example you may wish to allow only members of a project team to read that project’s files. Or, you 
may wish to prevent other users from altering the contents of a personal file. 

In the first situation, you would protect the project directory’s READ capability. By protecting a 
directory, you automatically restrict access to all directories and files subordinate to that directory. In 
the second situation, you would protect the file’s WRITE capability. The section on “Shared Access 
to Remote Directories and Files” discusses protection in more detail. 


Capabilities of Directories 

Directories are a type of file and, as such, can be: 

• created with the CREATE DIR statement. When a directory is created, its location in the 
hierarchical structure is fixed. 

• cataloged with the CAT statement, renamed with the RENAME statement, and protected with 
the PROTECT statement. 

• “filled” with subordinate files and directories using the COPY, CREATE BDAT, CREATE 
ASCII, CREATE DIR, SAVE, STORE, RENAME, RE-SAVE, and RE-STORE statements. Each 
subordinate file or directory is described in a 24-byte record in its superior directory. 

• opened and closed with the MASS STORAGE IS (MSI) statement. When a user’s MSI state¬ 
ment specifies a directory, any previously opened directory of that user is closed and the new 
one is opened. 

• “emptied” by removing all subordinate files and directories with the PURGE statement. 

• purged with the PURGE statement. You must close and empty a directory before purging it. 

Referring to Directories and Files in the Hierarchy 

To access either a directory or a file, you must specify its location in the hierarchical directory 
structure. This location is specified by a list of directories, called a directory path, that you must 
follow to reach the desired file or directory. Directory names in the list are delimited by a slash (/). 

For example, in the directory structure illustrated previously, the remote file specifier: 

"/ PROJECTS/P ro j e c t-.one / JOHN / f 1" 

defines the “path” to the file, fl, through its superior directories. 

The path to a file begins either at the root level or at the current working directory. The working 
directory is the directory specified by the most recent MASS STORAGE IS statement. 

This chapter s BASIC Language Reference section discusses the rules for specifying remote files 
and directories. 









How the SRM System Stores Remote Directories and Files 

To most efficiently use the shared disc space, the SRM system stores files non-contiguously and 
adds to space allocations for files as needed. 

Non-Contiguous Storage of Remote Files 

To avoid wasting disc space, the SRM system may fragment a file to fill unused disc sectors. This 
process is transparent and cannot be externally controlled. By filling the gaps automatically, the 
system eliminates the need to pack the shared disc’s files. 

Space Allocation for Remote Directories and Files 

SRM files and directories grow dynamically as data is entered into them. 

Rather than restricting a file’s space to that allocated when the file is created (for example, with a 
CREATE statement), the SRM system determines disc space requirements when data is sent to the 
file (for example, by an OUTPUT statement). If additional data placed into a file would cause the 
file to overflow its current space allocation, the system automatically allocates more space for the 
file. 

Similarly, directories grow only as entries are added. As a file or directory is created, another 
24-byte record is added to the containing directory. 

Files are extended as long as there is sufficient unused disc space on the same volume. Excess data 
from a file will not be placed on any other disc (volume) on the SRM system. 

Shared Access to Remote Directories And Files 

Because the sharing of files is a consequence of shared mass storage, the SRM system provides 
features for controlling access to shared information. 

Controlled Access: Password Protection 

The SRM system offers three kinds of access capability for files and directories: READ, WRITE, and 
MANAGER. Capabilities are either public (available to all workstations on the SRM) or protected 
(available only to users who know the appropriate password). 

Capabilities are protected with the PROTECT statement, which associates password(s) with one or 
more access capabilities. One password can be used to protect one or more capabilities. Each file or 
directory can have several password/capability pairs assigned to it. 

Once assigned, the password protecting an access capability must be included with the file or 
directory specifier to execute statements requiring that access. If you don t specify the correct 
password when it is required, the system will report an error and deny access to the file or directory. 

READ access capability for a file allows you to execute statements that read the file. READ access 
capability for a directory allows you to execute statements that read the file names in the directory, 
and to “pass through” the directory when the directory’s name is included in a directory path. 

For example, in the remote file specifier 

"/PROJECTS/ProJect_one<READpass>/JQHN/f1" 








including the assigned password <READpass> allows passage through the directory 
allow access to its subordinate directories and files. 


Project—one to 


WRITE access capability for a file permits you to execute statements that write to the file. WRITE 
access capability for a directory allows you to execute statements that add to or delete from the 
directory’s contents. 


With the MANAGER access capability, public capabilities for a file or directory differ slightiy from 
password-protected capabilities. Public MANAGER capability allows any SRM user to PROTECT 
PURGE or RENAME the file. The password-protected MANAGER capability provides MANAGER’ 

READ and WRITE access capabilities to users who include a valid password in the file or directory 
specifier. y 


The BASIC Language Reference” section in this chapter includes a table indicating the 

DDOTCrT 313 ' 1 ' 665 needed to u se each of the supported BASIC keywords. The description of the 
PROTECT keyword, also in that section, gives more details on protecting access to files and 
directories. 


Exclusive Access: Locking Files 

Although sharing files saves disc space, allowing several users access to one copy of a file introduces 
the danger of users trying to access the file at the same time, which can cause unpredictable results. 
For instance, if one user tries to read part of a file while another user is writing to it, the file’s 
contents may be inaccurate for the read. 

To avoid problems, the SRM system adds two BASIC keywords, LOCK and UNLOCK, which you 
can use to secure files during critical operations. LOCK establishes exclusive access to a file, which 
means that the file can only be accessed from the workstation at which the LOCK was executed. 

You may wish to LOCK a file, for example, during any procedure that writes new information to the 
file. 


To permit shared access to the file once again, UNLOCK must be executed from the same 
workstation, or the file must be closed. Only ASCII or BDAT files that have been opened by a user 
via ASSIGN may be locked explicitly by that user. 

Locking and unlocking is usually done from within a program. For more information refer to the 
descriptions of the ASSIGN, LOCK and UNLOCK keywords in the “BASIC Language Reference” 
section of this chapter. 

How the SRM System Manages Shared Peripheral Use 

The SRM system not only provides shared access to printers and plotters, but also manages their 
use so that workstations never need to wait for output to be generated. 

To use shared peripherals, you place files to be output into a special directory where they are held 
until the printer or plotter is free. The system keeps track of the order in which files arrive from the 
workstations, and outputs them in the same order. This method is called “spooling,” and the 
directory where the files are kept is called the “spooler directory.” Spooler directories are created 
for the SRM controller’s use when the shared peripherals are installed on the SRM system. 


After a file is placed in a spooler directory, the workstation is free to do other processing. 









Using Your BASIC Workstation on SRM 

This section describes, through examples, some of the more common procedures you’ll use when 
operating your BASIC workstation on the SRM, including: 

• booting from the SRM; 

• accessing the shared mass storage device; 

• creating directories and files; 

• listing a directory’s contents; 

• copying files; 

• using shared printers and plotters; 

• protecting files and directories; 

• purging files and directories; 

• accessing files created on non-Series 200 SRM workstations; 

• locking and unlocking files; 

• returning to local mass storage. 

This section illustrates both operations executed from the keyboard, and those executed within 
programs. 


Note About Key References 

Throughout this section, symbols for the keys used to execute state¬ 
ments and commands are shown with each statement or command. 

The ( EXECUTE ) symbol denotes the execution key on either the 
HP 98602A or HP 98602B keyb oards (t he keycap on the HP 98602A 
keyboard is labeled ( EXEC ) ). The f Return ) symbol denotes the execution 
key on the HP 46020A keyboard. 

You may also use the ( ENTER ) key on these keyboards to execute state¬ 
ments and commands. 


Booting From the SRM 

If your workstation has Boot ROM version 3.0 or later, you will be able to boot the BASIC language 
system into your workstation from the SRM. Once your workstation has been installed on the SRM 
system, the workstation powerup scheme your system manager has implemented on your SRM 
determines the exact procedure you use. This section discusses some general aspects of booting 
SRM workstations. 


Note 

Only HP Series 200 computers with Boot ROM version 3.0 or later can 
boot automatically from SRM. Refer to the BASIC User’s Guide for 
more information on how to determine which boot ROM your compu¬ 
ter has. Boot ROM 3.0L does not support automatic booting from 
SRM. 




















If your workstation’s boot ROM does not support booting from SRM, you must boot the BASIC 
system from a local mass storage device and load the SRM and DCOMM BIN files to allow the 
workstation to communicate with the SRM system. You may load these BIN files either from local 
mass storage or, if your boot ROM supports automatic booting, from the SRM (even though the 
SRM BIN file is not present in the workstation). 

For example, assume the SRM and DCOMM BIN files are in the directory named SYSTEMS at the 
root level of the SRM directory structure, and your workstation booted the BASIC system from the 
SRM. To load the BIN files from the SRM, you would type: 

LOAD BIN "/SYSTEMS/SRM" ( EXECUTE ) or (Return) 

then type: 

LOAD BIN "/SYSTEMS/DCOMM" ( EXECUTE 1 or (Return) 

If you load the SRM and DCOMM BIN files from the SRM, you must load SRM before 
DCOMM. 

Selecting an Operating System 

In general, when you power your workstation ON or perform a SYSBOOT while the workstation is 
powered (which returns control to the boot ROM to restart the system selection and configuration 
process), you can either select the BASIC system explicitly or an operating system is loaded 
automatically. 

If your workstation is not set up to automatically boot the BASIC system, you must explicitly select a 
system for the boot ROM to load into your workstation. Because explicit selection overrides any 
other method of system selection, you may choose this method over automatic selection when you 
wish to use an operating system other than the BASIC system. 

To explicitly select an operating system for the boot ROM to load at powerup, follow these steps: 

1. If your workstation’s power is OFF, turn the power ON. To boot while the power is ON, use 
the SYSBOOT command (described in the BASIC Language Reference). 


Note 

If your workstation is providing power to an SRM multiplexer, you 
should avoid turning the power off to reboot. 


2. Press any key within the first few seconds after the boot ROM’s initial activity begins (the 
workstation’s display begins to list the various parts of the computer for example, Keyboard) 
as each is recognized by the boot ROM). In response to the key press, the boot ROM then 
lists all systems currently available for loading into the workstation and waits for you to select 
a system. 

3. To the left of each system name is a two-character identifier, such as IB. To select a system, 
type the identifier and wait for the boot ROM to load the specified system. 





















Automatic Configuration 

Besides automatic selection of the boot system, your workstation may have an automatic configura¬ 
tion (“autostart”) file, which specifies operations to be performed by the BASIC system immediate¬ 
ly after it is loaded. For example, your workstation’s autostart file may cause the system to load 
certain BIN files and go directly into your directory each time you boot your system. 

If an autostart file exists for your workstation, all initial configuration happens automatically, without 
any extra effort from you. For information on setting up autostart files, refer to the BASIC User s 
Guide and the “Entering, Running and Storing Programs” chapter of the BASIC Programming 
Techniques manual. 

Accessing the Shared Mass Storage Device 

Your workstation accesses shared resources through the SRM controller, which is connected to the 
workstation through an HP 98629A interface in the workstation. The remote (SRM) mass storage 
device is identified by a remote mass storage unit specifier, or remote msus (similar to the local 
msus), which gives information about the SRM connection. The remote msus includes the following 
required and optional information: 

• the device type REMOTE, which specifies the SRM system; 


Note 

Instead of the REMOTE device type specifier, you may use the “gener¬ 
ic” form of the remote msus. Refer to the description of generic remote 
msus in the “BASIC Language Reference” section of this chapter. 


• (Optional) the interface select code of your workstation’s SRM interface. The default is the 
select code of the interface through which the boot ROM activates your workstation. (If you do 
not boot from the SRM, the default is the lowest select code of those available among the SRM 
interfaces in your workstation.) 

• (Optional) the controller’s node address; 

• (Optional) the volume name and volume password. 

The full syntax of the remote msus is described at the beginning of this chapter’s “BASIC Language 
Reference” section. 

In general, the first step in accessing a mass storage device is to make that device the MASS 
STORAGE IS device. Typing: 

MSI REMOTE" ( EXECUTE ) or ( Return) 

establishes the shared mass storage device as your workstation’s mass storage and causes the root 
to be the working directory. The working directory is the directory specified in the most recent MSI 
statement. (Refer to the section on “System Concepts” earlier in this chapter for more information 
about directories.) 

The form of the MSI statement shown above assumes that you want remote mass storage estab¬ 
lished according to the default values for your workstation’s interface select code, the controller s 
node address, and the SRM system volume. 















To find out the default values for these items, and to verify that your workstation’s mass storage is 
the SRM mass storage device, you can use the CAT statement to list the contents of the working 
directory. Your mass storage is the remote device if, when you type: 

CAT ( EXECUTE ) or ( Return) 

the directory header includes the remote msus (for example, : REMOTE 21, o). Refer to the CAT 
keyword entry in this chapter s BASIC Language Reference” section for an example of a remote 
directory catalog listing. If, as in this example, you do not specify the optional items in your remote 
msus, the default values are assumed and listed. 

To specify the remote mass storage when the SRM controller’s node address is 4 and the select 
code of your workstation’s interface is 15, you would type: 

MSI "iREMOTE 15,4" ( EXECUTE ) or ( Return) 

Creating Directories and Files 

For the following examples, assume you are working with the directory structure shown in the 
illustration below. 



Creating Directories 

To create a directory named CHARLIE in the directory, Project-one, you could type: 

MSI "SREMOTE" ( EXECUTE ) or ( Return) 

CREATE DIR "/PROJECTS/ProJect-one/CHARLIE" ( EXECUTE ) or (Return) 

The leading slash indicates that the directory path begins at the root of the SRM directory structure. 
You could accomplish the same thing by typing: 


CREATE DIR "PROJECTS/ProJect-one/CHARLIE;REMOTE" ( EXECUTE ) or (Return) 






































































10 


Using the leading slash to begin the directory path at the root works only if you have previously 
established the remote mass storage as your workstation’s mass storage (with some form of the 
MSI REMOTE" statement). 

This statement would place your newly-created directory into the directory structure as shown 
below. 



Creating Files and Other Directories Under a Directory 

To create files subordinate to a new directory, you may either establish the new directory as the 
working directory or specify the directory path to that directory. Assuming your current working 
directory is the root, you could type: 

MSI "PROJECTS/Project_one/CHARLIE" ( EXECUTE ) or ( Return) 
to move into the directory, CHARLIE. 

You could verify the new working directory with a catalog listing by typing: 

CAT ( EXECUTE ) or ( Return) 

On a computer whose screen supports an 80-character line width, the resulting listing would look 
something like this: 


PROJECTS/ProJect_one/CHARLIE:REMOTE 21 * 0 
LABEL: Disci 

FORMAT: SDF 

AVAILABLE SPACE: 54096 

SYS FILE NUMBER RECORD MODIFIED PUB OPEN 
FILE NAME LEV TYPE TYPE RECORDS LENGTH DATE TIME ACC STAT 


To create an ASCII file within CHARLIE, which is named ASCIL1 and is initially to contain 100 
records, you would type: 

CREATE ASCII " ASCI I_1"»100 f EXECUTE ) or (Return) 









































SXyouwouH CHARUE • Wh ' Ch ' S "™ d BMT - J “ d * >° contain 25 


CREATE BDAT "BDAT_1">25 ( EXECUTE ) or ( Return ] 

burnedM ^ ^ ^ SPeC ‘“ ed ‘ n ' he CREATE BDAT statement, the default 256-byte record size 

To create another directory within CHARUE called MEMOS, you would type: 

CREATE DIR "MEMOS" ( EXECUTE ) or (Return) 

The additions would make the directory structure look like this: 



(root) 


The simplest form of the CAT statement: 

CAT ( EXECUTE 1 or (Return) 

lists the contents of the current working directory because no directory is specifically identified. If no 
directory name is shown in the directory header, the current working directory is the root. 

™ U r,,T lted t0 liS ‘ * he COn,ents of CHARLIE . but your current working directory was not 
C HAHL1E, you could: 

• Designate CHARLIE as the working directory with the MSI statement, then use the CAT 
statement s “short form.” For example: 

MSI "PROJECTS/ Pro Ject_on e/CHARLIE:REMOTE" ( EXECUTE ) or ( Return ) 

CAT ( EXECUTE ) or fReturn) 

• In the CAT statement, specify the entire path to CHARLIE, starting at the root, by beginning 
the path name with a slash (/). For example: 

CAT " / PROJECTS/Project_one/CHARLIE" ( EXECUTE ) or (Return) 
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This form assumes that you have already designated remote mass storage with some form of 
the MSI ": REMOTE" statement. If you have not, use the form: 

CAT "PROJECTS/Pro ject_one/CHARLIE:REMOTE" ( EXECUTE") or (Rgtumj 
The leading slash is not necessary, because including : REMOTE specifies the root as the begin¬ 
ning of the path. 

• If you were in MEMOS (the directory immediately subordinate to CHARLIE), you could use 
the “ .. ” notation (explained with directory path syntax in the “BASIC Language Reference” 
section of this chapter). For example: 

cat ".. " ( EXECUTE ) or ( Return) 

For more details on specifying remote files and directories in BASIC statements, refer to the 
beginning of the “BASIC Language Reference section in this chapter. 

Copying Files 

With SRM, you can copy files between local and remote mass storage devices by any of the 
methods illustrated in the following examples. Again using the directory structure established for the 
other examples in this section, assume that the current working directory is CHARLIE. 


Using the COPY Statement 

The most direct method of copying a file from local to remote mass storage is to use the COPY 
statement. For example, to copy a PROG file named TesCprog that is on a local disc drive into the 
directory CHARLIE on the SRM system disc, you could type: 

COPY "Test_proS: INTERNAL" TO "Test-pros" ( EXECUTE ) or ( Return) 

By including the : INTERNAL msus, you can access the local mass storage without changing the 
current working directory (which is a remote directory). Refer to the “Data Storage and Retrieval 
chapter of the BASIC Programming Techniques manual for information on alternatives to the 
: INTERNAL msus for specifying local mass storage. 
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Other Uses of COPY 

The COPY statement can be used to copy files not only from local to remote mass storage but also 
from remote to local mass storage and from one remote mass storage device to another. You 
cannot copy directories, although you can copy files from one directory to another. Similarly you 
cannot copy an entire remote mass storage volume in a single COPY statement. (You must copy a 
remote volume file by file.) 


Suppose you want to copy the file BDATH from the directory CHARLIE into the directory AL (see 
previous illustration). 


Assuming the working directory is CHARLIE, you could type: 

COPY "BDAT_1" TO "/PROJECTS/Pro Ject_two/AL/BDAT_l " ( EXECUTE ) or ( Return) 


The effect of the copy on the directory structure is illustrated below: 



(root) 


Using LOAD and STORE 

You may also copy files by loading the program into your workstation from local mass storage and 
then storing it in remote mass storage. For example, to copy a PROG file named TesCprog that is 
on a disc in your workstation’s built-in disc drive into the directory CHARLIE on the SRM system 
disc (as demonstrated earlier using COPY), you could type: 

LOAD "Test_pros: INTERNAL" ( EXECUTE ) or (Return) 


Once the file is in your workstation’s memory, you may then store the file in the remote directory by 
using a statement such as: 

STORE "Test.pros" ( EXECUTE ) or (Return) 


Copying Item-by-Item Using ENTER and OUTPUT 

You may also copy a file from local to remote mass storage an item at a time, as illustrated in the 
programs that follow. These programs use the ENTER and OUTPUT statements to copy data 
item-by-item from a local BDAT file to remote mass storage. 
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The first program creates and fills a BDAT file named BDAT-FILE. 


10 

CREATE BDAT "1 

BDAT.FILE:INTERNAL"*10 

20 

ASSIGN @Local 

TO "BOAT-FILE:INTERNAL 

30 

! 


40 

FOR 11em = 1 TO 

50 

50 

OUTPUT SLocal 

5"St pindata item" 

GO 

NEXT Item 


70 

! 


80 

ASSIGN SLocal 

TO * 

90 

END 



The second program copies the contents of BDAT—FILE item-by-item into a file (also called 
BDAT-FILE) in the SRM directory named General (shown in the previous illustration). 

100 DIM St ririS_item$[20] 

110 CREATE BDAT "PROJECTS/General/BDAT.FILE:REMOTE" , 10 
120 ASSIGN SLocal TO "BDAT.FILE:INTERNAL" 

130 ASSIGN SRemote TO "PROJECTS/General/BDAT_FILE:REM0TE" 

140 ! 

150 FOR 11 e m = 1 TO 50 

ISO ENTER @ Local iStrin3_item$ 

170 OUTPUT @RemoteiStrin3_itern* 

180 NEXT Item 

190 ! 

200 ASSIGN @Local TO * 

210 ASSIGN SRemote TO * 

220 END 

Using a Shared Printer or Plotter 

Use of special SRM directories called “spooler directories” allows you to access a shared printer or 
plotter. Setting up a spooler directory is explained in the “Interfaces and Peripherals chapter of the 
SRM Operating System Manual. The examples in this section assume that the spooler directories 
LP (for “Line Printer”) and PL (for “PLotter”) have been created at the root of the SRM directory 
structure. 

Spooling Using PRINTER IS and PLOTTER IS 

You can use the PRINTER IS and PLOTTER IS statements to send data to your shared printer or 
plotter. The following command sequence illustrates this spooling method: 

CREATE BDAT "/LP/Print.f i 1 e" *1 
PRINTER IS "/LP/Print_fi le" 

LIST 

XREF 

PRINTER IS CRT 

PRINTER IS and PLOTTER IS work only with BDAT files. Because the SRM 1.0 operating 
system’s spooling works only with ASCII files, you cannot use PRINTER IS and PLOTTER IS for 
spooling with that version of SRM. 
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Note 

The DUMP DEVICE IS and PRINTALL IS statements do not support 
files, so cannot be used for printer spooling. 


Writing Files to the Spooler Directories 

You may also access the printer associated with LP by placing the data to be printed in an ASCII or 
BDAT file in that spooler directory. For example, to list a program currently in memory, you could 
SAVE the program in LP as the file PI—LISTING by typing either: 

SAME "LP/P1_LISTING:REM0TE" ( EXECUTE ) or fReturip 


or 


SAME "/LP/P1_LISTING" ( EXECUTE ) or (letum! 

The SAVE statement creates an ASCII file. Although this is the same syntax used to save programs 
on a shared disc, the SRM system knows that LP is a spooler directory and prints the file as soon as 
possible. 


Note 

When used for spooling, SAVE places a file in the spooler directory. The 
file is printed, then purged. You may wish to save or create the file first, 
then use the COPY statement to place the file into the spooler directory. 


Sending Program Output to a Shared Printer 

To spool program output to a shared printer, create an ASCII or BDAT file, assign an I/O path 
name to the file (which opens the file), and OUTPUT the data to that file. With BDAT files, you 
should ASSIGN with FORMAT ON. When the file’s contents are to be printed, close the file. The 
following example program segment outputs the data stored in the string array called Data$ to an 
ASCII file named PERFORMANCE. 

760 CREATE ASCII "/LP/PERFORMANCE" ,100 
770 ASSIGN @Spo o 1 TO "/LP/PERFORMANCE" 

780 OUTPUT @Spoolf 11 Performance Summary" 

790 OUTPUT @Spo o1>Data$(*) 

800 ASSIGN @Spoo1 TO * ! Initiate printing* 


The system waits until the file is non-empty and closed before sending its contents to the output 
device. If your file is not printed or plotted within a reasonable amount of time, you may not have 
closed it. You can verify that your file is ready to be printed or plotted by cataloging the spooler 
directory: 

CAT "/LP" ( EXECUTE ) or ( Return) 

The open status (open stat) of the file currently being printed or plotted is listed as locked (LOCK). 
Files currently being written to the spooler directory (either printer or plotter) are listed as OPEN. Files 
that do not have a status word in the catalog are ready for printing or plotting. 
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The SRM 2.0 operating system allows BDAT files to be sent to the printing device as a byte stream. 
(With SRM 1.0, only ASCII files can be used.) 


Note 

With the SRM 2.0 operating system, a BDAT file sent to the spooler is 
printed exactly as the byte stream sent. Unless you set up the BDAT file 
correctly, improper printer output or operation could result. Therefore, 
you should ASSIGN BDAT files with FORMAT ON before outputting 
data. 


The spooler prints each string and numeric item on a separate line by inserting a carriage return and 
line feed after each item. To put several strings on one line, concatenate them into one string before 
using OUTPUT to send them to the spooler file. You may insert ASCII control characters in the data 
by using the CHR$ string function. 

Appearance of Output 

Printed output for each file includes a one-page header, which identifies the directory path to the 
file, the file’s name, and the date and time of the printing. 

To cause the printer to skip the paper perforation after printing a page (60 lines), prefix your file 
name with “FF”. For example: 

SAME "/LP/FF-MYTEXT “ ( EXECUTE ) or ( Return) 

Preparing Plotters 

If your plotter does not feed its paper automatically, a message appears on the SRM controller 
screen indicating that the plotter needs to be set up. After you have put paper on the plotter, you 
may begin the plotting by using the controller’s SPOOL CONTINUE command (described in the 
SRM Operating System Manual). Plotters with automatic paper feed require no operator interven¬ 
tion. 

Aborting Printing/Plotting In Progress 

To abort an in-progress printing or plotting, use the SPOOL ABORT command from the SRM 
controller. The system stops sending data to the output device and closes, then purges the file. For 
details on bringing the spooler UP and DOWN, see the description of the SPOOLER command in 
the “Language Reference” section of the SRM Operating System Manual. 

With the SRM 2.0 operating system, if a printer is taken off-line while a file is being printed, the 
printer stops and resumes when the printer is put back on-line. No data is lost during such an 
interruption. The SRM 1.0 operating system also resumes printing, but from the beginning of the 
file. 

Protecting Files and Directories 

When you create directories and files, their access capabilities are “public” (available to any user on 
the SRM). You may subsequently protect a directory or file against certain types of access by other 
SRM workstations, provided: 

• you have MANAGER access capability on the file or directory (MANAGER access to the file is 
public or you know the password protecting the capability); 
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• you have READ access capability on the directory immediately superior to the file or directory 
you wish to protect; 

• you protect the file or directory either while in its superior directory or by specifying the valid 
directory path to its superior directory. 

For example, using the directory structure established for other examples in this section (see 
illustration) and assuming no passwords have been assigned to the files, you could: 



1. Assign the password passme to protect the MANAGER and WRITE access capabilities on the 
directory CHARLIE with the sequence: 

MSI "/ PROJECTS/Project_one" ( EXECUTE ) or (Return) 

PROTECT "CHARLIE" t ("passme":MANAGER (WRITE) ( EXECUTE ) or ( Return ) 

which executes the PROTECT statement after moving to the directory ProjecCone (im¬ 
mediately superior to CHARLIE). As a result of this PROTECT statement, the READ access 
capability on CHARLIE is still public, but any operations that require MANAGER or WRITE 
capabilities must include the password. 

2. Remove all public access capabilities from the file ASCIL1 by assigning the password 
no-pub, using: 

PROTECT "CHARLIE/ASCI I_l“ ,i "no_pub" : MANAGER (WRITE (READ) ( EXECUTE ) or ( Return ) 
or 


MSI "CHARLIE" ( EXECUTE ) or ( Return) 

PROTECT "ASCI I _ 1" ,( "no.pub" s MANAGER (WRITE (READ) ( EXECUTE ) or ( Return) 
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These statements assume you are in the directory, ProjecEone, as if you had executed the 
statements in the previous step. 

The second sequence of statements makes CHARLIE the new working directory, whereas in 
the first, you merely “pass through” CHARLIE to reach ASCII—1. With the READ access 
capability on CHARLIE still public, you do not need a password. 

3. Protect the file, BDAT-1, so that data can be read from it but not written into it without using 
the password, write. If the current working directory were CHARLIE, you would type: 

PROTECT "BDAT_1" > ("write": MANAGER t WRITE) ( EXECUTE ) or (Return) 

4. Protect the MANAGER access capability of the directory MEMOS with the password, 
mgr-pass (so that everyone can read from and write to the directory, but a password is 
required to purge the directory or its contents) by typing: 

PROTECT "MEMOS" t ( "m3 r.pass":MANAGER ) ( EXECUTE ) or (Return) 

If you protected the files and directory in CHARLIE as in the steps above, a catalog listing of 
CHARLIE would look something like this: 

PROJECTS/Projeot_one/CHARLIE:REMOTE 21 t 0 
LABEL: Disci 

FORMAT: SDF 


AVAILABLE SPACE: 

54096 








SYS 

FILE 

NUMBER RECORD 

MODIFIED 

PUB 

OPEN 

FILE NAME 

LEV TYPE 

TYPE 

RECORDS LENGTH 

DATE 

TIME 

ACC 

STAT 

n 

ii 

ii 

n 

ii 

ii 

ii 

n 

n 

ii 

ii 

n 

ii 

ii 

n 

ii 

ii 

ii 

ii 

=== ==== 

ii 

ii 

ii 

ii 

n 

ii 

ii 

ii 

ii 

n 

ii 

ii 

ii 

ii 

n 

n 

ii 

ii 

ii 

n 

ii 

ii 

ii 

n 

n 

n 

n 

n 

n 

ii 

====== 

= = = 

= = = = 

ASCII-1 

1 

ASCII 

0 256 

2-Dec-8a 

13:20 



BDAT_1 

1 98XG 

BDAT 

0 256 

2-Dec-8a 

13:20 

R 


MEMOS 

1 

DIR 

0 24 

2-Dec-8a 

13:20 

RN 



The letters in the column labeled pub ACC indicate access capabilities that are public (not protected 
with a password). For example, only the MANAGER (m) access capability on the directory MEMOS 
has been protected, leaving the READ (R) and WRITE (w) capabilities available to any SRM 
workstation user. 

Specifying Passwords 

When a password is required, you must include the correct password as part of the file or directory 
specifier in any command or statement that requires the protected access on the file or directory. 
The password must be enclosed between “ < ” and “ > ” and must immediately follow the name of 
the file or directory it protects. 

For example, to get the file ASCII-1, you might type: 

GET "/PROJECTS/ProJect_one/CHARLIE/ASCII_l<no_Pub >“ ( EXECUTE ) or ( Return) 

If the password were not included in the specifier, the system would respond with an error message 
and refuse to get the file. 
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Purging Remote Files and Directories 

The PURGE statement works the same for removing remote files as for removing files from local 
mass storage. You may also remove directories using PURGE. PURGE works only with closed files 
and directories. Directories must also be empty (not contain any files or directories). Refer to the 
discussion on “Returning to Local Mass Storage” later in this section for details on closing files and 
directories. 

When specifying the remote file to be purged, you must include all passwords protecting access 
capabilities required for the PURGE. For example, to purge the file BDAT-1 from the directory 
CHARLIE (see previous examples), you could type: 

PURGE ".< passme >/BDAT_l<w rit e >" ( EXECUTE ) or fReturip 

In this example, CHARLIE is the current working directory, as denoted in the directory path by 

“ . ”. (Refer to the syntax for directory path in this chapter’s “BASIC Language Reference” 
section.) 

To purge a file, you must have the MANAGER access capability on that file and READ and WRITE 
access capabilities on the file’s superior directory. Because passme protects the WRITE capability 
on CHARLIE and write protects the MANAGER capability on BDATH, both passwords must be 
included in the file specifier in the PURGE statement. 

Although you do not normally need to specify the working directory in a directory path, you must 
include the password for the PURGE operation. The READ capability on CHARLIE is not pass¬ 
word-protected. 

To purge CHARLIE, you would first need to purge the remaining files and directory in CHARLIE. 
Because the MSI statement “opens” a directory (making it the current working directory) you must 
also “close” CHARLIE 

For example, if no files or directories remained in CHARLIE, you could purge CHARLIE by typing: 
MSI "S REMOTE" ( EXECUTE ) or ( Return ) 

PURGE "PROJECTS/ProJeot_one/CHARLIE<passme) ( EXECUTE ) or ( Return) 

The first statement closes CHARLIE and establishes the root directory as the current working 
directory. Note that, because passme protects the MANAGER access capability on CHARLIE, you 
must include that password in the PURGE statement. 

Accessing Files Created on 
Non-Series 200 SRM Workstations 

Regardless of the kind of the computer or language system, files containing ASCII data can be 
shared among all workstations on the SRM. 

This example shows how you can access a remote ASCII file named Prog_x, which was created 
with the SAVE ASCII statement on an HP 9845 with the SAVE ASCII statement. 

In this example, Prog_x is in an HP 9845 workstation user’s directory called COMMON. 
COMMON is located in the directory WORLC45, which is at the root of the SRM directory 
structure. The password mypass protects the READ capability on WORPC45. All access capabilities 
on COMMON are public. 
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To access Prog-X, you would type: 

GET "WORK_45<mypass>/COMMON/ProS_x:REMOTE" f EXECUTE 1 or ( Return ) 
or 

GET “ /W 0 RK_ 45 <mypass >/C0MM0N/P ros(_x " f EXECUTE ) or ( Return) 

The system would then put Prog—X into your workstation. Keep in mind that, with GET, any lines 
containing BASIC syntax that is invalid in BASIC for the Series 200 computers will be stored as 
commented program lines ( ! ). 

Locking and Unlocking Remote Files 

You can “lock” a shared file with the LOCK statement, giving you sole access to that file. The same 
file can be locked several times in succession. Unlocking a file requires that you cancel all locks on 
that file. If you use the UNLOCK statement, you must cancel each LOCK with a corresponding 
UNLOCK. Using ASSIGN to re-open a locked file unlocks the file and you must execute another 
LOCK statement to lock the file again. Closing the file via ASSIGN @...TO * cancels all locks on the 
file. 

In this example, a critical operation must be performed on the file named File—a, and you do not 
want other users accessing the file during that operation. The program might be as follows: 

1000 ASSIGN ©File TO "Fi1e_a:REMOTE" 

1010 LOCK ©File jCONDITIONAL Result-code 

1020 IF Result-code THEN GOTO 1010 ! Try asain 

1030 ! Be Sin critical process 


2000 ! End critical process 

2010 UNLOCK ©File 

The numeric variable called ResulFcode is used to determine the result of the LOCK operation. If 
the LOCK operation is successful, the variable contains 0. If the LOCK is not successful, the 
variable contains the numeric error code generated by attempting to lock the file. 

Returning to Local Mass Storage 

When you have finished accessing shared resources, you should close all of your files and director- 
ies to “release” the system resources. 

Remote files are closed by ASSIGN ... TO * (see this chapter’s “BASIC Language Reference” 
section for details on ASSIGN). The SCRATCH A command closes directories and file s. All r emote 
files except those opened with the PRINTER IS statement are also closed by pressing ( RESET] . 

To close your current working directory, MSI to a local msus (for example, MSI ": INTERNAL"). 

If you booted from local mass storage, you may also execute the SCRATCH A command to 
completely release your access to the system. If you booted from the SRM, executing SCRATCH A 
resets the current working directory to the root. 
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Modifying Existing Programs 
to Access Shared Resources 

This section summarizes ways you can modify existing programs that access local resources to allow 
those programs to access shared resources. 

When modifying programs to access SRM-controlled mass storage device (s), you should be aware 
that: 

• Local and remote mass storage file specifiers may differ and string variable names that contain 
file specifiers may need corresponding modification. 

• References to mass storage unit specifiers (msus) throughout the program may have to be 
altered. 

• Allowances may have to be made for directory path specification. 

• Local protect codes may differ from passwords on remote files. The syntax for protecting 
remote files is different from that used for local files. 

File Specifiers 

Composition of File Names 

All file names for local mass storage are one to 10 characters long, while remote file names contain 
one to 16 characters. Remote file names can contain the period character ( . ) while local files 
cannot. If file name compatibility between resources is required, use 10 or fewer characters and do 
not use periods within remote file names. 

File and Mass Storage Device Specification in String Variables 

Modifying programs for use with shared resources generally requires changing the value, and often 
the length, of the string variables used to specify files and mass storage devices. The statements that 
assign the actual values to the string variables may have to be modified individually. 

Some programs use one string variable for the entire file specifier. For instance: 

100 DIM Fi 1 e_specifier*C32] 

110 LINPUT "Enter file specifier". File_specifier$ 

120 ON ERROR GOTO 110 ! Try aSain if improper specifier. 

130 ASSIGN SPath TO File-specifier* 

140 OFF ERROR 

If one variable is used for all file specifiers (as in the preceding example), only the length of the 
variable needs to be changed to allow for the additional characters allowed in remote file specifiers. 

The maximum number of characters that can be entered into a string variable from the keyboard in 
one operation is a good size for a file specifier variable. The Models 216, 220, 226 and 236 allow 
up to 160 characters and the Model 237 allows 256 characters. Thus, the length of 
Fi le-specif ie r$ in the preceding example’s DIM statement would be changed from 32 to 160 or 
256, accordingly. 

Note that the system mass storage (the current MASS STORAGE IS device) will be accessed if no 
msus is explicitly specified. 
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Mass Storage Unit Specification 

Some programs use separate variables for the file name and mass storage unit specifier. For 
example: 

ASSIGN @Path TO Fi1ename$&:Msus$ 

If so, both variables may have to be dimensioned to greater lengths. Allowing 34 characters for the 
file name variable accommodates a 16-character file name, a 16-character password, and the “<” 
and “>” password delimiters (for example, “ASCDEFGHIJ123456<1234567890123456>”). 
The remote msus may occupy up to 54 characters. 

Other programs may use MASS STORAGE IS statements throughout the program instead of 
including the msus in each file specifier. For instance: 

MASS STORAGE IS Left_drive$ 

ASSIGN ©File TO File.name* 

Unless variable(s) are used to specify the msus and each variable is assigned a value in only one 
place, you may have to modify each MASS STORAGE IS statement to specify the desired remote 
mass storage device. 

Allowing for Directory Paths 

Suppose the following program needs to be modified to include a remote file’s directory path. 

100 DIM Fi 1 enaiiie$[ 14] tMsus$[20] 


500 Fi1en ame$=" SL I DES " 
510 Msus$ =":HP9895.700" 


1000 ASSIGN ©File TO Fi 1 er,ame$&Msus$ 
1010 OUTPUT @Fi1eiDat a(*) 

1020 ASSIGN ©File TO * 


2000 ASSIGN ©File TO Filename$&Msus« 
2010 OUTPUT @FileiData(*) 

2020 ASSIGN ©File TO * 









In this example, it is probably easiest to add another string variable for the (optional) directory path 
name. For example: 

100 DIM Dir_path$[1G01»Fi1enawe$C803»Msus$[80] 

♦ 

500 Dir_path$="FRED/DATA_FILES/" 

510 F i 1 eriame$= "SLIDES" 

520 Msus$=":REM0TE 21 »1" 


1000 ASSIGN ©File TO Dir_path*&Fi1enameS&Msus* 

1010 OUTPUT @Fi 1e iData(*) 

1020 ASSIGN SFile TO * 

If the D i r - P a t h $ variable is null, the statement looks exactly like it did before the modification. If the 
Ms us* variable is null, the current mass storage device is accessed. The only difference is in the 
allowable length of the string variables. 

Passwords and Protect Codes 

The PROTECT statement format for remote files is different form the format for local files. Depend¬ 
ing on the type of mass storage is being used, you can use either of the following to decide which 
syntax will be used: 

1. Try the non-SRM syntax with an ON ERROR statement enabled. If an error occurs, see if it 
indicates that the mass storage device is an SRM. An Error 1 occurs when the following 
statement is executed on a remote file. 

PROTECT file specifier,protect code 

2. If the program uses a string to store the mass storage unit specifier, check for a non-zero 
value of P0S( Msus$ ("REMOTE" ). This alternative is easier to implement than alternative 1 but 
will not work if the program accesses the default device when Ms us* is empty. 

If the program looks for a password error (Error 62) at ASSIGN time, the program may have to be 
modified because the system may not detect the password error until an ENTER @Path or 
OUTPUT @Path is attempted. 
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BASIC Language Reference 
for HP Series 200 SRM Workstations 

This section lists all BASIC keywords either used exclusively with SRM or whose use with SRM 
differs from that described in the BASIC Language Reference manual. 

Most keyword entries in this section describe only differences between the keyword’s normal use 
and its use on SRM. Because SRM-specific keywords are not described in the BASIC Language 
Reference manual, full details of their use are included in this section. 

You may wish to remove this language reference section and insert it as an appendix to your 
BASIC Language Reference manual. SRM-specific keywords (CREATE DIR, LOCK and 
UNLOCK) are described on separate pages, so you can insert those keywords into their correct 
alphabetical position in the main BASIC Language Reference manual. Be sure not to discard these 
pages if you replace your BASIC Language Reference manual with a newer version. 

The primary difference in keyword syntax for SRM use is in file specification. Use of supported 
keywords on SRM requires you to supply a remote file specifier rather than the file specifier 
described for non-SRM uses of BASIC. Some keywords also involve a directory specifier, which is 
unique to SRM. Remote file specifiers and directory specifiers are described at the beginning of this 
section. 

In addition, you must be aware of the access capabilities required on files and directories involved 
in the keyword’s use. Access capability requirements are summarized in a table included in this 
section. 

This section is not a complete language reference for the BASIC keywords listed. Instead, each 
keyword entry shows the SRM-specific use of the keyword and supplies details relevant to that use. 
The BASIC Language Reference manual completely describes the BASIC keywords. 


Note 

This section reflects the keywords and uses for BASIC 3.0. The “SRM 
and BASIC 2.0” appendix lists differences between the BASIC 2.0 and 
BASIC 3.0 uses. 
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Syntax for Remote File 
and Directory Specification 

The following syntax applies to remote file specification for BASIC keyword use on SRM. The 
semantics discussion applies to all remote file specification unless otherwise noted with a specific 
keyword’s description. 

Remote File Specifier 



Item 

Description/Default 

Range Restrictions 

directory path 

literal 

(see diagram) 

remote file name 

literal 

any valid remote file 
name (see Semantics) 

password 

literal, first 16 non-blank characters are signifi¬ 
cant 

any valid password (see 
Semantics) 

remote msus 

literal 

(see diagram) 


Semantics 

A valid remote file name consists of one to 16 characters, which may include uppercase and 
lowercase letters, digits 0 through 9, the underbar (_) character, the period ( . ) character, and 
national language characters (CHR$(161) through CHR$(254)). Spaces are ignored. 

A valid password consists of one to 16 characters, which may include any ASCII character except 
“ > ”• Spaces are ignored. Passwords are assigned by the PROTECT keyword. 

If no directory path is included, the system assumes the file is in the current working directory (the 
directory specified in the latest MASS STORAGE IS statement). To specify a file in a directory other 
than the current working directory, specify the directory path to the desired file. (Refer to the syntax 
for directory path later in this section.) The directory path may begin at the current working 
directory or at the root. 

The READ access capability for each directory included in the directory path must be public or the 
password that currently protects the READ capability must be included in the remote file specifier. A 
maximum of six identifiers can be included in a specifier - five directories in the path and the target 
file. If the target file is more than five directories away from the current working directory, move 
closer by changing the working directory (with MSI). 
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Examples 

"PROJECTS/WRITERS/samp les<ur_pass>:REMOTE 21.1 !LABELV0L_TI40<waster>" 

illustrates the full remote file specifier syntax. For explanations of the directory path and remote 
msus portions of this illustration, see the examples with those components. 

"thisfile" 

specifies a file that is in the current working directory. This form assumes that the SRM (remote 
mass storage) has previously been “entered” via some form of the MSI ":REMOTE" statement. 

Directory Path 



Item 

Description/Default 

Range Restrictions 

directory name 

literal 

any valid directory name 
(see Semantics) 

password 

literal, first 16 non-blank characters are signifi¬ 

any valid password (see 

cant 

Semantics) 


Semantics 

A valid directory name consists of one to 16 characters, which may include uppercase and 
lowercase letters, digits 0 through 9, the underbar ( _ ) character, the period ( . ) character, and 
national language characters (CHR$(161) through CHR$(254)). Spaces are ignored. 

A valid password consists of one to 16 characters, which may include any ASCII character except 
“ > Spaces are ignored. Passwords are assigned by the PROTECT. 

A leading slash (/) in the directory path specifies that the path begins at the root. If you have not 
previously established the remote mass storage (using, for example, MSI REMOTE"), you must 
include some form of the remote msus with the file specifier. Including the remote msus also 
specifies that the directory path begins at the root. Remote msus is explained later in this section. 

Subsequent slashes delimit individual names in the path. 

Using “ .. ” in place of a directory name specifies the directory immediately superior to the current 
directory position. (Note that the root’s superior directory is the root.) Using “ . ” in place of a 
directory name specifies the current directory position. To specify a file or directory subordinate to 
the current working directory, you do not include the current working directory in the directory 
path. 
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Examples 

The directory path: 

/USERS/BO/MANUAI_PLAN<mine*alone> 

begins at the root. 

The directory path: 

. ./filet 

begins at the directory immediately superior to the current working directory. 
The directory path: 

PROJECTS/WRITERS/writers_only>/samples:REI , IDTE 


begins at the root. 


The directory path: 
d i r_sub/fi1e 1 


begins in the current working directory. In this example, di r_sub is immediately subordinate to the 
current working directory. 

Remote msus 



Item Description/Default Range Restrictions 


SRM interface select 
code 

integer constant 

8 through 31 

SRM controller’s node 
address 

integer constant 

0 through 63 

volume name 

literal 

any valid volume name 
(see Semantics) 

volume password 

literal 

any valid password (see 
Semantics) 
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Semantics 

The volume name, which is assigned at the volume’s initialization, is used to identify a mass storage 
volume. Volume names consist of one to 16 characters, which may include uppercase and lower¬ 
case letters, digits 0 through 9, the underbar ( _ ) character, the period (. ) character, and national 
language characters (CHR$(161) through CHR$(254)). 

A valid volume password consists of one to 16 characters, which may include any ASCII character 
except “ > 

The volume password allows complete access to all files on a mass storage volume, and is assigned 
when the volume is initialized. The volume password supercedes all access restrictions placed on 
files and directories by the PROTECT statement. 

You need supply the SRM interface select code only if you wish to specify an SRM interface in 
your Series 200 workstation other than that identified by the default select code. If your workstation 
boots from the SRM, the default is the select code of the interface through which the boot ROM 
activates your workstation. If your workstation boots from a source other than SRM, the default 
select code is the lowest available SRM interface select code in the workstation. (The factory-set 
default value for the HP 98629A interface’s select code is 21.) 

The SRM controller’s node address is necessary only if the node address of the controller is other 
than the default controller’s node address. 

To determine the defaults for your workstation use the following command sequence: 

MSI REMOTE" f EXECUTE ) or (Return) 

CAT ( EXECUTE ) or (Return) 

The header of the resulting catalog listing shows the default values for your workstation’s SRM 
interface select code and SRM controller’s node address, and the name of the default SRM system 
volume. 

If you include the controller’s node address, you must also include the SRM interface select code. 

The LABEL secondary keyword identifies a volume, and is used mainly when more than one 
shared volume is on the SRM system. You need supply the volume label only if you are identifying 
a volume other than the default SRM system volume (in an SRM system having more than one 
shared disc) or if your application requires that you specify the volume password. 

The Generic Remote msus 

The generic msus syntax (not indicated in the syntax diagram above) bypasses the need for all 
information required by the remote msus syntax except the workstation’s SRM interface select 
code. An example of this msus syntax is: 

: >21 
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Examples 

The remote msus: 

: REMOTE 

specifies the default SRM system volume. 

The remote msus: 

:REMOTE 21t1iLABEL YOL_TWO<secondpass> 

specifies an SRM system volume. The LABEL syntax allows inclusion of the volume password in 
the remote msus. Note that, because the controller’s node address is not the default and must be 
specified, the SRM interface select code must also be specified, even if that select code is the 
default. 

Directory Specifier 



Item 

Description/Default 

Range Restrictions 

directory path 

literal 

(see diagram) 

directory name 

literal 

any valid directory name 
(see Semantics) 

remote msus 

literal 

(see diagram) 


Semantics 

A valid directory name consists of one to 16 characters, which may include uppercase and 
lowercase letters, digits 0 through 9, the underbar ( _ ) character, the period (. ) character, and 
national language characters (CHR$( 161) through CHR$(254)). Spaces are ignored. 

If no directory path is included, the current working directory (the directory specified in the latest 
MASS STORAGE IS statement) is assumed for the keyword’s use. To specify a directory other than 
the current working directory, specify the directory path to the desired directory. (Refer to the 
syntax for directory path.) The directory path may begin at the current working directory or at the 
root. 

The READ access capability for each directory included in the directory path must be public or the 
password that currently protects the READ capability must be included in the remote file specifier. A 
maximum of six directories may be included in the directory specifier. If the target directory is more 
than five directories away from the current working directory, move closer by changing the working 
directory (with MSI). 
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Examples 

ii j n 

specifies the root. This form assumes that the SRM (remote mass storage) has previously been 
“entered” via some form of the MSI ": REMOTE" statement. (See directory path description.) 


specifies the directory three levels superior to the current working directory. (See directory path 
description.) 

" ,<MGR_pass>" 

specifies the current working directory, with a password granting an access capability different from 
that currently in effect. 


Access Capability Requirements 

Because SRM allows password protection of files and directories, either certain access capabilities 
must be public or you must supply the password protecting those capabilities when you specify the 
file or directory in the keyword syntax. For more information on password protection and access 
capabilities, refer to the section on “Shared Access to Remote Directories and Files” earlier in this 
chapter and the PROTECT keyword entry in this reference. 

The following chart lists BASIC keywords discussed in this section, indicating for each: 

• whether the keyword is used with remote files, directories, or can be used with either; 

• the access capabilities required on the directories superior to the specified directory or file; 

• the access capabilities required on the specified directory or file itself. 

Access requirements do not apply to the following keywords: 

CHECKREAD 

CONTROL 

INITIALIZE 

ON TIMEOUT 

RESET 

SCRATCH A 

STATUS 

UNLOCK 

SYSTEMS 


Note 

For all keywords listed in the table, the READ capability must be public 
on all directories in the path to the target remote file or directory. 
Otherwise, you must supply the password protecting the READ capabil¬ 
ity on any such directory. 
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The entries in the following table indicate the access capabilities needed for use of the designated 
keyword. That is, the access capability listed must either be public (not protected with a password) 
or you must supply the password protecting the capability in the file or directory specifier included 
with the keyword. 

For example, in an OUTPUT statement, if the WRITE capability on the file to which the data is to be 
written is not public, you must supply the password entitling you to write data to that file. (You 
would include the password as part of the remote file specifier in the statement assigning the I/O 
path name for the file to which the data is directed.) If the READ capability on the directory 
containing the remote file specified in the OUTPUT statement is not public, you must supply the 
appropriate password with the directory name in the directory path to the remote file. 


Access Capabilities Required for Keyword Use 


Keyword 

Applies to 

Access Capabi 
Directory/ 

File 

ilities Required 
Superior 
Directory 

ASSIGN 

file 

at least 1 

READ 

CAT 

either 

READ 

READ 

COPY 




source 

file 

READ 

READ 

destination 

file 

— 

READ & WRITE 

CREATE ASCII 

file 

— 

READ & WRITE 

CREATE BDAT 

file 

— 

READ & WRITE 

CREATE DIR 

directory 

— 

READ & WRITE 

ENTER 

file 

READ 

READ 

GET 

file 

READ 

READ 

LOAD 

file 

READ 

READ 

LOADSUB 

file 

READ 

READ 

LOCK 

file 

at least 1 

READ 

MASS STORAGE IS 

directory 

— 

READ 

OUTPUT 

file 

WRITE 

READ 

PLOTTER IS 

file 

at least l 1 

READ 

PRINTER IS 

file 

at least l 1 

READ 

PROTECT 

either 

MANAGER 

READ 

PURGE 

either 

MANAGER 

READ & WRITE 

RENAME 

either 

MANAGER 

READ & WRITE 

RE-SAVE 

file 

READ & WRITE 

READ & WRITE 

RE-STORE 

file 

READ & WRITE 

READ & WRITE 

RE-STORE KEY 

file 

READ & WRITE 

READ & WRITE 

SAVE 

file 

— 

READ & WRITE 

STORE 

file 

— 

READ & WRITE 

STORE KEY 

file 

— 

READ & WRITE 

STORE SYSTEM 

file 

— 

READ & WRITE 

TRANSFER 




inbound 

file 

READ 

READ 

outbound 

file 

WRITE 

READ 


Dash ( -) means “does not apply. ” 


1 The statement, however, is not useful without WRITE access to the file. 
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Using Protected Files Created on a Pascal Workstation 

The password protection assigned with the Pascal Filer’s Access command imposes some restric¬ 
tions on the use of BASIC keywords with a file protected with that command. 

If a Pascal file’s SEARCH capability alone is protected, the BASIC catalog listing will show the file’s 
READ capability as public. The protection assigned for SEARCH, however, limits the types of 
BASIC read operations that can be performed on that file without the assigned password. For 
example, you can catalog a directory whose READ access capability is public and whose SEARCH 
access capability is not, but you cannot access any of the files or directories within that directory. 


Similarly, the MANAGER access capability in BASIC encompasses the Pascal MANAGER, 
CREATELINK and PURGELINK capabilities. 


BASIC vs. Pascal Protections 


BASIC 

Access Capability 


Equivalent Pascal Access Capability 


MANAGER 

READ 

WRITE 


MANAGER, CREATELINK. PURGELINK 

READ, SEARCH 

WRITE 
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Summary of BASIC Keyword Use on SRM 

This section lists, in alphabetical order, the BASIC keywords that can be used with SRM and those 
that are unique to SRM (CREATE DIR, LOCK, PROTECT, the CAT PROTECT option, 
UNLOCK). Each keyword description in this section discusses only uses or features of the keyword 
that apply to its use on SRM. 

Syntax diagrams appear only with those keywords requiring a different syntax for use with SRM. 
Where syntax diagrams are not included, you may follow the syntax described in the BASIC 
Language Reference manual, substituting remote file specifier syntax (described in the previous 
section) wherever “file specifier” is indicated in the keyword’s syntax. 

For access capability requirements, refer to the chart in the previous section. 
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ASSIGN 


With SRM, I/O path names can be assigned to remote files, attributes can be assigned to the I/O 
path, and I/O paths can be closed. The following syntax and discussion describes only the use of 
ASSIGN with remote files. See the BASIC Language Reference manual for details of other uses of 
ASSIGN and the description of attributes associated with ASSIGN. 



Example Statements 

ASSIGN @Remote_fi 1 e TO "DIR_J0HN/dir_proJ/fi1e1“ 

ASSIGN SFile TO "Pl/FredsData<pass>:REMOTE" 

Semantics 

Assigning an I/O path name to a remote file associates the I/O path with the file at the specified or 
default mass storage location. 

ASSIGN opens any existing ASCII or BDAT file, regardless of protection on the file except when all 
access capabilities (MANAGER, READ and WRITE) are taken from the public. Attempts to use 
ASSIGN with a file whose capabilities are fully protected (without supplying the necessary pass¬ 
words) result in Error 62. 

In all other instances, a file’s access capabilities are not checked at ASSIGN time. The specified 
operation on the file associated with the I/O path name is not executed, however, unless the file has 
the necessary access capability for that operation. For example, you may ASSIGN an I/O path 
name to a file that has only the READ capability public, but attempting to perform an OUTPUT 
operation without the password protecting the WRITE access capability generates Error 62. 

ASSIGN does not create a file. 

ASSIGN and Locked Files 

Existing ASCII or BDAT files opened via ASSIGN are opened in shared mode, which means that 
several users can open a file at the same time. If you lock a file (refer to LOCK) and subsequently 
open that file via ASSIGN using the same @<name> (for example, to reset the file pointer), the 
ASSIGN automatically unlocks the file (refer to UNLOCK). To maintain sole access to the file, you 
must LOCK it again. 

Closing an I/O path via ASSIGN (ASSIGN @...TO *) unlocks as well as closes the file (regardless of 
the number of LOCKs in effect for the file at the time). 
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CAT 


With SRM, CAT lists all or specified portions of the contents of a directory or information regarding 
a specified PROG file. SRM adds the PROTECT option to the CAT statement. For a full description 
of the CAT statement syntax and CAT options, refer to the BASIC Language Reference manual. 



Example Statements 

CAT 

CAT TO #701 
CAT ":REMOTE" 

CAT 

CAT "DIR1/DIR2" 

CAT "A/B/CsREMOTE" 

CAT "M'/_Fi 1 e" iPROTECT 
CAT ": REMOTE i LABEL Masteruol" 
CATiSELECT "D"» SKIP Ten-files 
CAT TO Director'/$(*) i NO HEADER 
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Semantics 

To catalog remote directories, either you must include a remote msus in the CAT statement or the 
latest MASS STORAGE IS statement must have specified the desired remote msus. A catalog entry 
is listed for each file in the working or explicitly specified directory. 


CAT to a Device 

The catalog listing format used by the SRM system depends upon the line-width capacity of the 
device used for display. 


When cataloging a remote directory on a 50-column display, the SRM system uses the following 
catalog format: 

header 


USERS/STEVE/PROJECTS/D IR1:REMOTE 21 tO 
LABEL: Disci 

FORMAT: SDF 

AVAILABLE SPACE: 54096 



PUB 

FILE 

NUMBER 

RECORD 

OPEN 

FILE NAME 

ACC 

TYPE 

RECORDS 

LENGTH 

STAT 

================ 

= = = 

= = = = = 

======= 

====== 

= = = = 

Common-data 

MRU 

ASCII 

48 

256 

OPEN 

Personal-data 


BDAT 

33 

256 

LOCK 

P ro S ram_alpha 

RW 

PROG 

44 

256 


HP9845-DATA 

R 

DATA? 


256 


HP9845-ST0RE 

MRW 

PROG? 

9 

256 


Pascal-fi1e♦TEXT 

MRW 

TEXT 

37 

256 


P ro sf ram-500 

MRW 

PROG? 

12 

256 



line 1 
line 2 
line 3 
line 4 
line 5 
line 6 


When cataloging a remote directory on an 80-column display, the SRM system uses the following 
catalog format: , , 

noarior 


USERS/STEVE/PROJECTS/DIR 1:REMOTE 21»0 
LABEL: Disci 

FORMAT: SDF 


AVAILABLE SPACE: 

54096 

SYS 

FILE 

NUMBER 

FILE NAME 

LEV 

TYPE 

TYPE 

RECORDS 

Common-d at a 

1 

= = = = 

ASCII 

48 

Pe rsonal-data 

1 

98X6 

BDAT 

33 

Prosram_alpha 

1 

98X6 

PROG 

44 

HP9845-DATA 

1 

9845 

DATA 

r ? r ? 

HP9845-ST0RE 

1 

9845 

PROG 

9 

Pascal-file,TEXT 

1 

PSCL 

TEXT 

37 

P ro S ram-500 

1 

9000 

PROG 

12 







line 1 






line 2 






line 3 






line 4 

RECORD 

MODIFIED 

PUB 

OPEN 

line 5 

LENGTH 

DATE 

TIME 

ACC 

STAT 

line 6 

256 

2-De c-83 

13:20 

MRW 

OPEN 


256 

2-Dec-83 

13:20 


LOCK 


256 

3-Dec-83 

IS: 6 

RW 



256 

lO-Qct-83 

8:45 

R 



256 

10-Oct-83 

8:47 

MRW 



256 

11-Nov-83 

12:25 

MRW 



256 

13-Dec-83 

9:54 

MRW 




The header gives you the following information: 

line 1 Directory name and remote msus. The full path to the specified directory is 

displayed. Passwords used in the path are not displayed. 


If the directory path specifier contains more characters than the display width, 
the last 49 or 79 characters (depending on catalog format) in the path specifier 
are shown. An asterisk (*) as the leftmost character in the path specifier 
indicates that leading characters were truncated for the display. 
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The system remembers a maximum of 160 characters for any directory path 
specifier at a single time. If a path specifier contains more than 160 characters, 
the excess characters are removed from the beginning of the specifier and are 
not retained. This restriction does not affect movement within the directory 
structure. 

line 2 Volume label of the volume containing the directory. 

line 3 Directory format, such as SDF (Structured Directory Format). See your disc’s 

operating manual for details. 

line 4 Number of bytes available on the volume (given in increments of 256 bytes). 

lines 5 and 6 Labels for columns of information given for each file. The information pro¬ 

vided is summarized below. 

The file NAME column lists the names of the remote files and directories in the directory. 

The LEM column (80-column format only) shows the level of the file relative to the current working 
directory or specified directory. The level is always shown as 1 in directory listings for Series 200 
workstations. 

The PUB ACC column lists the access capabilities available to all SRM system users. The three 
capabilities are READ, (R) WRITE (w) and MANAGER (m). 

• Public MANAGER capability on a file or directory allows any user on the SRM system to 
PURGE that file or directory and to modify or add to its passwords (with PROTECT). Pass- 
word-protected MANAGER capability gives users who supply the required password both 
READ and WRITE capabilities as well as MANAGER capability. 

• READ capability on a directory allows you to access any file or directory in the directory. The 
READ capability on a file allows you to read the contents of the file. 

• WRITE capability on a directory allows you to create or delete a file or directory in that 
directory. The WRITE capability on a file allows you to write information into that file. 

The SYS type column (80-column format only) shows the type of system used to create the file. 
The system type is not shown for ASCII files and directories. 98X6 denotes a Series 200 computer. If 
the SRM system does not recognize the system type, a coded identifier, obtained from the system 
being identified, appears in this column. 

The FILE TYPE column indicates the file’s type. Directories are indicated as type DIR. In the 
50-column format, a question mark is appended to the file type if the file was not created on a 
Series 200 computer and was a type other than ASCII or DIR. For example, in the display 
illustrated earlier, DATA and PROG files created on an HP 9845 are listed as such, but shown with 
the question mark. 

File types recognized by the BASIC system on SRM are: ASCII, BDAT, BIN, DIR, PROG, and 
SYSTM, as well as Series 200 Pascal and Series 500 file types. 

If the system does not recognize a file’s type, a coded file type identifier, obtained from the system 
originating the file, appears in the FILE TYPE column. 
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TheNUMBER OF RECORDS column indicates the number of records in the file and theRECORD length 
column indicates the number of bytes constituting each of the file’s records. 

The modified columns (80-column format only) show the date and time the file’s contents were last 
changed. 

The OPEN STAT column shows whether the file is currently open (open), locked (lock) or corrupt 
(corr). OPEN indicates that the file has been opened, via ASSIGN, by a user. An open file is available 
for access from other workstations. LOCK means the file is accessible only from the workstation at 
which the file was locked. CORR indicates that the disc lost power while accessing the file, possibly 
altering the file’s contents. If the entry is blank, the file is closed and available to any user. 


Note 

If a file’s status is shown as corrupt (CORR), you should run the DSCK 
Utility program to check the directory structure and its integrity on the 
SRM system disc. Refer to the SRM Operating System Manual for 
details. 


CAT to a String Array 

Regardless of the workstation’s display width, a CAT to a string array always produces the 
80-column format. 

The PROTECT Option 

PROTECT is a CAT option provided by the SRM BIN file and available only on SRM. This option 
also requires the MS BIN file. The PROTECT option displays the password(s) and associated access 
capabilities for the specified file or directory. 

For example, the statement: 

CAT "Test_file<MPASS>sREMOTE" iPROTECT 

might produce the display: 

PASSWORD CAPABILITY 

MPASS MANAGER (READ (WRITE 

WPASS WRITE 

RPASS READ 

PASSWORD MANAGER 

Use of this option requires MANAGER access capability on the file or directory. If the MANAGER 
capability is public, the PROTECT option may be used by any SRM user. 

PROTECT must be specified separately from other CAT options, and is allowed only with SRM files 
and directories. Using PROTECT with media other than SRM results in 
ERROR 1 Configuration error. 
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CHECKREAD 


For SRM, CHECKREAD is implemented as a no-op, because the CHECKREAD function is already 
performed for every read and write statement on the SRM. Further checking places overhead on 
the system and doing so would not be accurate. With SRM, CHECKREAD may or may not cause 
a true write to the disc, while its read would probably only access the buffers in the SRM system. 
SRM’s internal read and write checking and the automatic checking on the link make using 
CHECKREAD unnecessary. 
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CONTROL 


With SRM, CONTROL sends control information to the internal table associated with an I/O path 
name assigned to an ASCII or BDAT file (see ASSIGN). Refer to the CONTROL keyword entry in 
the BASIC Language Reference manual for a full explanation of CONTROL syntax. 

Control registers are listed in the “I/O Path Status and Control Registers” table in the Interface 
Registers section of the BASIC Language Reference manual. 



Example Statement 

CONTROL @Rand_file »7SFi1e_lenSth 
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COPY 


With SRM, COPY allows copying of individual remote files. Remote directories and volumes 
cannot be copied. 


old remote 
file specifier 


^GD-*E25 


Example Statements 

COPY "/Dir_l/File_l" TO "Dir_3/Fi1e_l" 

COPY "File:INTERNAL" TO "File:REMOTE 21 »0" 

COPY Dir_path$&:File$&:l v lsu5&: TO "Fi 1 e : INTERNAL" 

Semantics 

The contents of the old remote file are copied to the new remote file and an entry is placed in the 
destination directory. The old and new remote files may be in the same directory, but the new 
remote file’s name must be unique. 


Although you may include a password in the new remote file specifier, the system ignores the 
password. If you wish to protect access to the new file, you must assign the password with 
PROTECT. 
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CREATE ASCII 


With SRM, CREATE ASCII creates a new remote ASCII file, placing a corresponding directory 
entry in the current working directory or specified remote directory. 

Example Statements 

CREATE ASCII "Text03"t 100 

CREATE ASCII "/Dirl/Dir2/ASCII FILE" .25 

Semantics 

The name of the newly-created ASCII file must be unique within its containing directory. 

CREATE ASCII does not open the file. Files are opened with the ASSIGN statement. If an error 
occurs during execution of CREATE ASCII, no directory entry is made and the file is not created. 

The specified number of records determines the number of physical records for a remote ASCII 
file’s initial space allocation. The physical records of an ASCII file have a fixed length of 256 bytes. 
(Logical records have variable lengths, determined automatically when an OUTPUT, SAVE or 
RE-SAVE statement is used.) 

Storage space for subsequent saving of remote files is allocated only when needed. When data is 
added to a remote file such that saving the modified file would overflow the file’s current space 
allocation, the SRM system adds another extent. An extent is a space allocation whose size is 
determined by multiplying the specified number of records by the record size. 

When the remote file is created, all access capabilities are public. Including a password in the 
CREATE ASCII statement’s remote file specifier does not protect the file. You must use PROTECT 
to assign passwords. You will not receive an error message for including a password, but passwords 
in the CREATE ASCII statement are ignored. 
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CREATE BDAT 


With SRM, CREATE BDAT creates a new remote BDAT file, placing a corresponding directory 
entry in the current working directory or specified remote directory. 

Example Statements 

CREATE BDAT "Fi 1 e" »Records'tRec.size 
CREATE BDAT "/Dirl/Dir2/BDATFILE" .25.128 
CREATE BDAT "Dir/Fi lesREMOTE"»10 

Semantics 

The name of the newly-created BDAT file must be unique within its containing directory. 

CREATE BDAT does not open the file. Files are opened with the ASSIGN statement. If an error 
occurs during execution of CREATE BDAT, no directory entry is made and the file is not created. 

The specified number of records determines the number of physical records for a remote BDAT 
file s initial space allocation. The length of a BDAT file’s physical records is either specified by the 
record size parameter or set to 256 bytes if no record size is specified. 

Storage space for subsequent saving of remote files is allocated only when needed. When data is 
added to a remote file such that saving the modified file would overflow the file’s current space 
allocation, the SRM system adds another extent. An extent is a space allocation whose size is 
determined by multiplying the specified number of records by the record size. On SRM, CREATE 
BDAT does not allocate a sector for system use, as it does with local files. 

When the remote file is created, all access capabilities are public. Including a password in the 
CREATE BDAT statement’s remote file specifier does not protect the file. You must use PROTECT 
to assign passwords. You will not receive an error message for including a password, but passwords 
in the CREATE BDAT statement are ignored. 

The data in remote BDAT files can be accessed both serially and randomly. 
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CREATE DIR 


Option Required SRM,DCOMM 

Keyboard Executable Yes 
Programmable Yes 

In an IF...THEN... Yes 

This statement creates a directory in either the current working directory or in the specified remote 
directory of an SRM mass storage device. 


C 


CREATE DIR 


d irectory 
sped f ier 


Example Statements 

CREATE DIR "Under_worK.dir" 

CREATE DIR "Leve 11/Leve12/New_dir:REMOTE 21 »3" 

CREATE DIR "/Leve11/LeMe 12/New_dir" 

CREATE DIR "LevelKRWpasswo rd>/New_di r" 

Semantics 

This statement creates a special 24-byte file of type DIR and a corresponding directory entry in the 
current working directory or specified remote directory. The DIR file, or directory, keeps informa¬ 
tion on files and directories immediately subordinate to itself. 

The name of the newly-created directory must be unique within its containing directory. 

Like remote data files, DIR files are extensible. Extents are added in 24-byte increments. As each 
directory or data file is created within a directory, a 24-byte record identifying the addition is added 
to the DIR file. 

If no directory path is included in the directory specifier, the directory is created within the current 
working directory (the directory specified in the latest MASS STORAGE IS statement). To specify a 
target directory other than the current working directory, specify the directory path to the desired 
directory. 

You cannot assign passwords to a directory when you create it. Passwords are assigned only via 
PROTECT. If an error occurs during execution of CREATE DIR, the directory entry in the superior 
directory is not made, and the directory is not created. 

DIR files are opened with the MASS STORAGE IS (MSI) statement. 

Refer to the section on “Syntax for Remote File and Directory Specification” earlier in this chapter 
for details on the semantics of directory specifiers. 












46 


ENTER 


With SRM, ENTER is used to read data from a remote data file identified by an I/O path name and 
to assign the value(s) to variable(s). (See also ASSIGN.) 

The capabilities available for using ENTER with remote files are the same as those for using ENTER 
with local files. Refer to the ENTER keyword entry in the BASIC Language Reference manual for a 
full explanation of ENTER syntax. 



Example Statements 

ENTER @Remote_file tRECiAlpha*(Beta*(Gamma* 
ENTER @Nafne_of 5 A 


Semantics 

Entering data from remote files requires the READ access capability on the superior directory and 
on the file from which the data are to be read. If this capability is not public or if a password 
protecting this capability was not used at the time the file was ASSIGNed, an error is reported 
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GET 


With SRM, GET reads the specified remote ASCII file and attempts to store the data in memory as 
program lines. 

Example Statements 

GET "Filename:REMOTE" 

GET ”/Dirl/Di r 2 / Di r3/f i 1 ename<READpass >" 

Semantics 

You may use GET with any ASCII file whose data is in the format of a BASIC program (that is, 
having numbered lines). Although you may also use GET with ASCII files created on non-Series 
200 SRM workstations (HP 9835, HP 9845 or Model 520), any line that is not valid BASIC syntax 
for Series 200 computers is stored as a commented ( ! ) program line. 

When used on SRM, GET is executed in shared mode, which means that several users can get one 
file at the same time. Attempts to get a locked file (see LOCK) result in Error 453. Additionally, you 
cannot get a file while it is being saved. The SAVE and RE-SAVE operations open the file in 
exclusive mode (shown as LOCK in a CAT listing) and enforce that status until the SAVE or 
RE-SAVE is complete. While in exclusive mode, the file is accessible only to the SRM workstation 
executing the SAVE or RE-SAVE. 








48 


INITIALIZE 


With SRM, INITIALIZE can be executed from the controller only. You cannot use INITIALIZE from 
a workstation on SRM. 
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LOAD 


With SRM, LOAD loads the contents of remote PROG or BIN files into memory, or sets the 
typing-aid definitions of the softkeys according to the contents of a remote BDAT file. 

Example Statements 

LOAD "Pros rain.z" 

LOAD "/Dirl/Dir2/ProS2",500 
LOAD "Dir3/ProS_l:REMOTE" 

LOAD BIN Dir$5:File$&:Msus$ 

LOAD BIN "dirl/dir 2/bin _ fi1e<Read pass>:REMOTE 21,5 iLABEL Disc" 

LOAD KEY "KEYS:REMOTE" 

LOAD KEY "/Dirl/Di r2/Keyf i le" 

Semantics 

LOAD 

LOAD can be used with remote PROG files (created with the STORE statement). LOAD is 
executed in shared mode, which means that several users can load a file at the same time. Files 
being stored with the STORE or RE-STORE statements are locked during that operation and 
cannot be accessed for loading. 

LOAD BIN 

LOAD BIN can be used with remote BIN files. LOAD BIN is executed in shared mode, which 
means that several users can load a BIN file at the same time. 

BIN files can be loaded into a workstation from the SRM without the SRM BIN file present in the 
workstation. Refer to the “Booting from SRM” section of this chapter for more details. 

LOAD KEY 

LOAD KEY can be used with remote BDAT files (created with the STORE KEY statement). LOAD 
KEY is executed in shared mode, which means that several users can perform a LOAD KEY from a 
BDAT file at the same time. Files being stored with the STORE KEY or RE-STORE KEY statements 
are locked during that operation and cannot be accessed for loading. 
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LOADSUB 


With SRM, LOADSUB allows you to load subprograms from a remote PROG file into your 
workstation. 

Example Statements 

LOADSUB FROM "APSUBS" 

LOADSUB FNReplace* FROM "SUBFILE" 

LOADSUB ALL FROM Subfile* 

LOADSUB ALL FROM "Dir3/ProSfi1e<Readpass>" 

LOADSUB ALL FROM "/Di rl/Di r2/Pro*23" 

Semantics 

With SRM, LOADSUB is executed in shared mode, which means that several workstations can 
perform a LOADSUB of a file at the same time. PROG files being stored with the STORE or 
RE-STORE statement are locked during that operation and cannot be accessed for loading. 
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LOCK 


Option Required 
Keyboard Executable 
Programmable 
In an IF...THEN... 


SRM,DCOMM 

Yes 

Yes 

Yes 


This statement prevents other SRM workstations from accessing the remote file to which the I/O 
path name is currently assigned (see ASSIGN). 


(TociTM^ Pna^^ | -<y XcONDITIONAL) -» 


return 

variable 


Item 

Description/Default 

Range Restrictions 

I/O path name 

name identifying an I/O path 

any valid name (See 


Glossary.) 

return variable 

name of a numeric variable 

any valid name (See 


Glossary.) 


Example Statements 

LOCK @Fi1e(CONDITIONAL Result 

LOCK @Asci i_liCONDITIONAL Error.number 

Semantics 

This statement establishes sole access to a file that has been opened with an ASSIGN statement. 
This exclusive access remains assigned to the workstation executing the LOCK statement until an 
UNLOCK statement is executed by that workstation. The UNLOCK function is also a result of 
SCRATCH A, (RESET) and ASSIGN...TO * (explicitly closing an I/O path). 

A file may be locked several times. The system counts the number of LOCKs on a file, and an equal 
number of UNLOCKS must be executed to unlock the file. When an I/O path name is closed (for 
example, by ASSIGN...TO *), all LOCKs of that I/O path name are cleared. 

If the LOCK is successful, the value of the return variable will be zero. Otherwise, the return 
variable’s value will be the error number corresponding to the cause of the LOCK’S failure. 
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MASS STORAGE IS 

With SRM, MASS STORAGE IS specifies the SRM working directory. 



Example Statements 

MSI “Dirl/Dir2/Project-.dir" 

MSI “♦♦" 

MASS STORAGE IS “♦•(password)" 

MSI ":REMOTE“ 

Semantics 

SRM allows directories or volumes to be assigned as system mass storage. If you specify the volume 
password in an MSI statement, that password is automatically applied to all accesses that use the 
default msus (that is, no remote msus is specified in the remote file specifier) until a remote msus is 
included in a subsequent MSI. 

























ON TIMEOUT 


With SRM, ON TIMEOUT defines and enables a branch resulting from an I/O timeout on the 
specified SRM interface. Although ON TIMEOUT is supported on SRM, its use should be avoided 
because the asynchronous nature of the SRM system does not allow predictable results. 

A TIMEOUT occurring during statements such as RE-SAVE and RE-STORE may leave a tempor¬ 
ary file on the mass storage device. The file s name is a 10-character identifier (the first character is 
an alpha character, the rest are digits) derived from the value of the workstation’s real-time clock 
when the TIMEOUT occurred. You may wish to check the contents of any such file before purging. 
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OUTPUT 


With SRM, OUTPUT writes item(s) to the remote file to which the specified I/O path name is 
assigned (see ASSIGN). Refer to the OUTPUT keyword entry in the BASIC Language Reference 
manual for a full explanation of OUTPUT syntax. 



Example Statement 

OUTPUT @Fi1eiArray(*)»END 


Semantics 

You must have WRITE access capability on the remote file to output data to the file. If this capability 
is not public or if a password protecting this capability was not used at the time the file was 
ASSIGNed, Error 62 is reported. 

If the data output to the file with this statement would overflow the file’s space allocation, the system 
allocates the additional space needed to save the file (provided the disc contains enough unused 
storage space). Refer to the ’’System Concepts” section of this chapter for more details on the 
extensible nature of remote files. 
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PLOTTER IS 


With SRM, PLOTTER IS causes all subsequent plotter output to go to the specified remote BDAT 
file. Refer to the PLOTTER IS keyword entry in the BASIC Language Reference manual for a full 
explanation of PLOTTER IS syntax. 


(plotter is)-* 


remote file 
spec i f ier 


—** ( ‘HPGL* ) - 



Example Statements 

PLOTTER IS "/PL/Plotfile" 

PLOTTER IS "Plotfile:REMOTE" P'HPGL"»S.25 .25G.25 .6.075,186.975 


Semantics 

If the specified remote file is in the SRM plotter spooler directory and the file contains data, when 
the file is closed the SRM system sends the data to the plotting device and then purges the file. You 
may close the file by executing another PLOTTER IS statement, SCRATCH A or SCRATCH BIN, 
or by pressing [RESET) . 

No end-of-file error occurs on SRM. If the data output to the file with this statement would overflow 
the file’s space allocation, the system allocates the additional space needed to save the file (pro¬ 
vided the disc contains enough unused storage space). Refer to the “System Concepts” section of 
this chapter for more details on the extensible nature of remote files. 
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PRINTER IS 


With SRM, PRINTER IS specifies a remote BDAT file as the system printing file. Refer to the 
PRINTER IS keyword entry in the BASIC Language Reference manual for a full explanation of 
PRINTER IS syntax. 



Example Statements 

PRINTER IS "Spoole r:REM0TE" 

PRINTER IS "My_dir/Temp_print"iWIDTH 80 

Semantics 

The system printing file receives all data sent by the PRINT statement, all data sent by CAT and 
LIST statements in which the destination is not explicitly specified, and other output generated by 
the BASIC system. 

If the specified remote file is in the SRM printer spooler directory and the file contains data, when 
the file is closed, the SRM system sends the data to the printer and then purges the file. You may 
close the file by executing another PRINTER IS statement, or a SCRATCH A or SCRATCH BIN 
command. 

No end-of-file error occurs on SRM. If the data output to the file with this statement would overflow 
the file’s space allocation, the system allocates the additional space needed to save the file (pro¬ 
vided the media contains enough unused storage space). Refer to the “System Concepts” section 
of this chapter for more details on the extensible nature of remote files. 
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PROTECT 


With SRM, this statement protects access capabilities by assigning passwords to remote files and 
directories. The use of PROTECT with SRM is distinct from its use with local files (described in the 
BASIC Language Reference manual). 



Example Statements 

PROTECT "dir:REMOTE" t("m4r":MANAGER)t("rw":READ(WRITE) 
PROTECT "File<rw>"»("rw":DELETE) 


Semantics 

PROTECT allows you to control access to remote files and directories by protecting access capabili¬ 
ties with password(s). Access capabilities are either public (available to all SRM users) or password- 
protected (available only to users supplying the correct password with the file or directory specifier). 

The three access capabilities - MANAGER, READ and WRITE - are public unless the PROTECT 
statement associates a password with one or more of those capabilities. 

Once the capability on a given file or directory is password-protected, the capability can be exer¬ 
cised on the file or directory only if the correct password is included in the file or directory specifier. 
For instance, if a file’s READ capabilities are protected, any user wishing to execute a command or 
statement that reads the file must supply a password protecting the file s READ capability. 

MANAGER 

Public MANAGER capability allows any SRM user to PROTECT, PURGE or RENAME a file or 
directory. Password-protected MANAGER capability provides READ and WRITE, as well as MAN¬ 
AGER, access capabilities to users who know the password. 

You must have MANAGER capabilities on a file or directory to PROTECT the access capabilities on 
that file or directory. This includes adding, deleting and changing passwords. 

READ 

READ capability on a file allows use of commands and statements that read the contents of a file 
(for example: ENTER, LOAD, GET). READ capability on a directory allows you to read the files in 
the directory (CAT), or to “pass through” a directory by including the directory name (and 
password, if assigned) in a directory path. 
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WRITE 

WRITE capability on a file allows use of commands and statements that write to the file (for 
example: OUTPUT, RE-SAVE, RE-STORE). WRITE capability on a directory allows use of com¬ 
mands that add or delete file names in the directory (for example: SAVE STORE PURGE 
CREATE, RENAME). 

Use of PROTECT 

Each PROTECT statement allows up to six password/capability combinations per statement. The 
number of PROTECT statements that can be executed for each file or directory is unlimited, 
however, as long as each password is unique. 

Successive associations of capabilities with the same password are not cumulative. To retain 
previous capability assignments for a file or directory, you must include those assignments in 
subsequent PROTECT statements designating the same password for that file or directory. 

For example, say you protected the READ access capability on a file with the password passme 
then wanted to change that assignment so that passme would protect both the READ and WRITE 
access capabilities for that file. If you executed a second PROTECT statement associating passme 
with the WRITE capability only, passme would no longer protect the READ capability. Instead, you 
should specify the password and both the READ and WRITE capabilities in the second PROTECT 
statement. 

To modify the access capabilities protected by a password, execute the PROTECT with the existing 
password and the new password/capability pair(s). 

The secondary keyword DELETE is used to delete existing password assignments for a file or 
directory. To be effective, DELETE must be the only secondary keyword used with a password/ 
capability pair in the PROTECT statement. Otherwise, DELETE is ignored. MANAGER capability is 
required to perform the DELETE. A DELETE executed without MANAGER capability results in a 
protect code violation error. 
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PURGE 


With SRM, PURGE deletes a file entry from a directory or an empty remote directory from its 
superior directory. 


(purge)- 


remote file 
specifier 


M 


d irectory 
spec i f ier 


Example Statements 

PURGE "File" 

PURGE "Di r_a<RI*lpass>/File<MGRpass> 
PURGE "Dirl/Dir2/Dir3" 


Semantics 

Only remote files and directories that are closed can be purged. Remote files are closed by 
ASSIGN...TO * (explicitly closes an I/O path). SCRATCH A closes both directories and remote 
files. All remote files except those opened with the PRINTER IS statement are also closed by 
(RESET) . The current working directory is closed by an MSI to a different directory. 

Once a file or directory is purged, its contents cannot be recovered. 

To be purged, directories must be empty (must not contain any subordinate files or directories) as 
well as closed. 
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RENAME 


With SRM, RENAME changes a remote file’s name in a remote directory and performs limited file 
relocation. 



Example Statements 

RENAME "01d_name“ TO "New.name" 

RENAME "Dirl<RWpass>/Fl<MGRpass>" TO "Dir2<RWpass>/Fl" 

RENAME "THIS:REM0TE" TO "THAT" 

Semantics 

RENAME can be used to change the name of remote files and directories or to move files within the 
directory structure. Directories cannot be moved with RENAME. Moving of files must occur within a 
single volume. If you move a file with RENAME, the original file (“old remote file specifier”) is 
purged. 

A maximum of nine names (file or directory) are allowed in the combined file/directory specifiers in 
the RENAME statement. No more than six names are allowed in either specifier individually. (The 
number of names in the old file/directory specifier plus the number of names in the new file/ 
directory specifier must not exceed nine.) 

Files and directories must be closed before being renamed. Remote files are closed by 
ASSIGN...TO * (explicitly closes an I/O path). SCRATCH A closes both directories and remote 
files. A ll remote files except those opened with the PRINTER IS statement are also closed by 
(RESET) . The current working directory is closed by an MSI to a different directory. 

Existing passwords are retained by the renamed file or directory. The new file name must not 
duplicate the name of any existing file in the destination directory. 
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RE-SAVE 


With SRM, RE-SAVE creates a remote ASCII file and copies program lines as strings into that file. 

Example Statements 

RE-SAME "File" 

RE-SAME "Dir<RWpas5>/File<RWpass>" 

Semantics 

RE-SAVE opens the remote file in exclusive mode (denoted as LOCK in a CAT listing) and enforces 
that status on the file until the RE-SAVE is complete. While in exclusive mode, the file is inaccessible 
to all SRM workstations other than the one executing the RE-SAVE. 

If the file does not already exist, RE-SAVE performs the same action as SAVE. Including a pass¬ 
word in the RE-SAVE statement’s remote file specifier does not protect the file. Passwords are 
assigned only with PROTECT. You do not receive an error for including a password with the 
specifier of a remote file that does not already exist, but the system ignores the password. 

Passwords assigned to an existing file are retained when a RE-SAVE is performed on the file. If you 
specify the wrong password on a protected file, the system returns an error message. 

Use of RE-SAVE on SRM may leave temporary files on the mass storage media if (CLR I/O) or ( RESET) 
is pressed or a TIMEOUT occurs during the RE-SAVE. The file name of the temporary file is a 
10-character name (the first is an alpha character, others are digits) derived from the value of the 
workstation’s real-time clock when the interruption occurred. You may wish to check the contents 
of any such file before purging. 
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RESET 


With SRM, this statement resets the pointers of a remote file identified by an I/O path name (see 
ASSIGN). 


I/O path 
name 


Example Statement 

RESET @Remote_file 
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RE-STORE 


With SRM, RE-STORE creates a remote file and stores the BASIC program or typing-aid key 
definitions in that file. 

Example Statements 

RE-STORE "P ro 3_a" 

RE-STORE "Dir<RWpass>/Pro3_z<RWpass>" 

RE-STORE KEY "KEYS:REMOTE" 

RE-STORE KEY "TYPING" 

Semantics 

RE-STORE creates a remote FROG file, and RE-STORE KEY creates a remote BDAT file. 

RE-STORE opens the remote file in exclusive mode (denoted as LOCK in a CAT listing) and enforces 
that status on the file until the RE-STORE is complete. While in exclusive mode, the file is inaccessi¬ 
ble to all SRM workstations other than the one executing the RE-STORE. 

If the file does not already exist, RE-STORE performs the same action as STORE. Including a 
password in the RE-STORE statement’s remote file specifier does not protect the file. Passwords 
are assigned only with PROTECT. You do not receive an error for including a password with the 
specifier of a remote file that does not already exist, but the system ignores the password. 

Passwords assigned to an existing file are retained when a RE-STORE is performed on the file. If 
you specify the wrong password on a protected file, the system returns an error message. 

Use of RE-STORE on SRM may leave temporary files on the mass storage media if (CLR l/Oj or 
(RESET) is pressed or a TIMEOUT occurs during the RE-STORE. The file name of the temporary file 
is a 10-character name (the first is an alpha character, others are digits) derived from the value of 
the workstation’s real-time clock when the interruption occurred. You may wish to check the 
contents of any such file before purging. 
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SAVE 


With SRM, SAVE creates a remote ASCII file and copies program lines as strings into the file. 

Example Statements 

SAME "THE-WHALES" 

SAME "Di r<Rklpass >/Fi 1 e " 

SAME "Ascii_file:REMOTE" 

Semantics 

SAVE opens the remote file in exclusive mode (denoted as LOCK in a CAT listing) and enforces that 
status on the file until the SAVE is complete. While in exclusive mode, the file is inaccessible to all 
SRM workstations other than the one executing the SAVE. 

Including a password in the SAVE statement’s remote file specifier does not protect the file. 
Passwords are assigned only with PROTECT. You do not receive an error for including a password 
with the remote file specifier, but the system ignores the password. 
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SCRATCH A 


With SRM, SCRATCH A releases the system resources allocated to the workstation executing the 
SCRATCH A, making those resources available to other SRM workstations. SCRATCH A closes all 
files and directories, and resets the workstation’s working directory to the default msus (the mass 
storage unit from which the workstation booted). 

If the workstation has Boot ROM version 3.0 or later, and booted from the SRM, SCRATCH A 
resets the working directory to the root of the default system volume. If the workstation has an 
earlier version boot ROM or Boot ROM 3.0L, SCRATCH A resets the working directory to the 
device from which the workstation booted (for example, :INTERNAL if the workstation booted 
from a built-in drive). 
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STATUS 


With SRM, STATUS returns the contents of I/O path name status registers (see ASSIGN). Refer to 
the STATUS keyword entry in the BASIC Language Reference manual for a full explanation of 
STATUS syntax. Status registers are listed in the “I/O Path Status and Control Registers” table in 
the Interface Registers section of the BASIC Language Reference manual. 



Example Statement 

STATUS @Fi1e»5 iRecord 
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STORE 


With SRM, STORE creates a remote file and stores a program or typing-aid key definitions into it. 

Example Statements 

STORE "Pro*32" 

STORE "Dir<RWpass>/Pro*ram" 

STORE KEY "KEYS:REMOTE" 

STORE KEY "/USERS/KRIS/TYPING" 

Semantics 

STORE creates a remote PROG file, and STORE KEY creates a remote BDAT file. 

STORE opens the remote file in exclusive mode (denoted as LOCK in a CAT listing) and enforces 
that status on the file until the STORE is complete. While in exclusive mode, the file is inaccessible 
to all SRM workstations other than the one executing the STORE. 

Including a password in the STORE statement’s remote file specifier does not protect the file. 
Passwords are assigned only with PROTECT. You do not receive an error for including a password 
with the remote file specifier, but the system ignores the password. 
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STORE SYSTEM 


With SRM, STORE SYSTEM stores the entire BASIC operating system currently in memory 
(including any BIN files) into the specified remote file. 

Example Statements 

STORE SYSTEM "SYSTEM.Bl:REM0TE" 

STORE SYSTEM "/SYSTEMS/SYSTEM-NEW" 

Semantics 

Including a password in the STORE SYSTEM statement’s remote file specifier does not protect the 
file. Passwords are assigned only with PROTECT. You do not receive an error for including a 
password with the remote file specifier, but the system ignores the password. 

The READ access capability on the system file created with STORE SYSTEM must be public to 
allow use of the file for booting. 
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SYSTEMS 


With SRM, this function returns a string containing system status and configuration information. 


( SYSTEMS ~)-*(T)- H information | ~~*~(A) H 


literal form of type of information: 



Example Statement 

SYSTEMS("MSI") 

SYSTEMS("PRINTER IS") 

SYSTEMS("PLOTTER IS") 

Semantics 

The system configuration information returned when SYSTEMS is executed on SRM includes the 
full remote file specifier describing the file or directory about which the information is requested. 
Passwords in the specifier are not included. 

The system remembers a maximum of 160 characters for any one specifier. If a specifier contains 
more than 160 characters, the excess characters are removed from the beginning of the specifier 
and are not retained. An asterisk (*) as the leftmost character in the specifier indicates that leading 
characters were truncated for the function. 
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TRANSFER 


With SRM, this statement initiates unformatted data transfers between the workstation and remote 
mass storage devices. Either the source or destination of the transfer is specified as an I/O path 
name assigned to a remote BDAT file (see ASSIGN). Refer to the TRANSFER keyword entry in the 
BASIC Language Reference manual for a full explanation of TRANSFER syntax. 

Example Statements 

TRANSFER SBuffer TO OFileiCONT 

TRANSFER @Dir_Path TO @Destination 5COUNT 258 

TRANSFER OSource TO @Buffer?DELIM "/" 

TRANSFER @Path TO @Buffer5RECORDS 12*E0R(C0UNT 8) 

Semantics 

TRANSFER behaves the same on SRM as with local mass storage, except that inbound and 
outbound transfer execution is not overlapped. Whereas the discs on the SRM may be cabable of 
overlapped operation, the SRM system performs TRANSFERS serially. This difference only matters 
in applications, such as data logging, where you may want a program to be able to execute other 
statements before the transfer has completed. For further details, refer to the “Transfer Perform¬ 
ance” section in the “Advanced Transfer Techniques” chapter of the BASIC Interfacing Techni¬ 
ques manual. 
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UNLOCK 


Option Required 
Keyboard Executable 
Programmable 


In an IF...THEN... 


SRM,DCOMM 

Yes 

Yes 

Yes 


This statement is used to remove exclusive access (placed by the LOCK statement) to a remote file 
identified by an I/O path name (see ASSIGN). 


C UNLOCK )—»(@^ 


I/O path 
name 


Item 

Description/Default 

Range Restrictions 

I/O path name 

name identifying an I/O path to a remote file 

any valid name (See 
Glossary.) 


Example Statements 

UNLOCK ©File 

IF Done THEN UNLOCK ©File 

Semantics 

This statement unlocks a file previously locked with the LOCK statement. While a file is locked, 
other SRM workstations cannot access the file. After UNLOCK, other users may access the file 
provided they possess the proper access capability (or capabilities). 

If multiple LOCKs were executed on the file, the same number of UNLOCKS must be executed to 
unlock the file. 

UNLOCK is performed automatically by SCRATCH A, (RESET) and ASSIGN...TO * (explicit closing 
of an I/O path). 
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SRM BASIC Error Codes 
for HP Series 200 Computers 


450 Volume not found 

451 Volume labels do not match 

453 File is use 

454 Directory formats do not match 

455 Possibly corrupt file 

456 Unsupported directory operation 

457 Passwords not supported 

458 Unsupported directory format 

459 Specified file is not a directory 

460 Directory not empty 

461 Duplicate passwords not allowed 

462 Invalid password 

465 Invalid rename across volumes 

466 Duplicate volume entries 

481 File locked or open exclusively 

482 Cannot move a directory via a RENAME 

483 System down 

484 Password not found 

485 Invalid volume copy 
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HP Series 200 

Chapter 

Pascal Workstation Use on SRM 

2 


The Shared Resource Management system (SRM) connects several workstations (computers) to 
form a network that allows sharing of files and peripherals. This network is controlled by a system 
controller. 

The Pascal language system incorporates features to access shared resources. This chapter outlines 
the use of an HP Series 200 computer operating under Pascal as an SRM workstation. 


Note 

This chapter summarizes Pascal language features that support the use 
of SRM and does not include a comprehensive discussion of Pascal 
language system terms and concepts. 

For detailed information, refer to the Pascal User’s Guide and the Pascal 
Workstation System manual (previously the Pascal User’s Manual). 
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System Concepts 

How Your Workstation Connects to SRM 

To use the SRM system, you need to know how to move information from one point to another in 
the system. Everything in the SRM system has a name and/or address. This section is a guided tour 
of the SRM configuration. 

Your Workstation’s Identification 

Your workstation’s contact with the SRM system is through an HP 98629A (Resource Management 
Interface) card. This card is placed in one of the Input/Output slots in the rear of your computer. 

Your workstation is uniquely identified to the SRM system by its node address, assigned when the 
workstation was added to the SRM system. The node address is set on the HP 98629A card by 
means of switches on the card. 

The HP 98629A card also has a setting called the select code, which should normally be left at 21. 
All of the software shipped to you that uses your workstation’s select code expects to see 21. See 
the SRM Hardware Installation Manual for information on the HP 98629A interface card. 

The Connection to the SRM Controller 

Your workstation’s HP 98629A card connects to an HP 98028A multiplexer by a cable. Other 
workstations may connect to the same multiplexer, with each workstation having a different node 
address. 

The multiplexer has a cable connecting it to the SRM system controller. The controller end of the 
cable attaches to another HP 98629A interface card in the controller. 

The Controller’s Identification 

The controller card’s node address setting is normally 0 for all HP 98629A cards in the system’s first 
SRM controller, 1 for the second controller, and so on. 

The SRM system controller may contain several HP 98629A interface cards. Unique select code 
settings distinguish one HP 98629A interface in the controller from another. 

Identification of Shared Disc(s) 

Each SRM controller can have multiple shared disc drives connected to it. From your workstation’s 
point of view (as shipped), only one shared disc is available. The Pascal operating system automati¬ 
cally configures to have Pascal volume #5: assigned to the primary (first) SRM system disc. 

Additional discs on the SRM system are recognized only if your Pascal CTABLE program is 
modified. (The procedure is discussed in the chapter on “System Startup” and is typically done by 
your SRM system manager when the disc is configured to the SRM system.) 
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Unit Numbers for Shared Disc(s) 

A workstation connected to an SRM normally has units #5: and #45: set up for SRM shared disc 
access. The use of two units is in keeping with the idea that there are usually two special volumes 
(the system volume and the default volume) through which most file accesses occur. 

If the workstation is booted from SRM, unit #45: will automatically be configured to be the system 
volume and unit number #5: will be available for use as the default volume. If there is local mass 
storage, the system volume can be any volume you desire. To set the system and default volumes, 
use the What command from the Main Command Prompt. 

Here is how the Filer’s Volumes display might look right after booting up a workstation connected 
to the SRM and having no local mass storage: 

Vo 1umes on-line: 

1 CONSOLE: 

2 SYSTERM: 

5 # SRM: 

6 PRINTER: 

45 * SYSTEM42: 

Prefix is - SRM: 

You can see that the system starts out with #5: as the default volume (Prefix is) and #45: as the 
system volume. 

The names SRM: and SYSTEM42: are names of directories in the SRM’s hierarchical directory 
structure (discussed later in this section). In this example, the name of the SRM volume is SRM, the 
workstation we are using is at node address 42, and a directory called SYSTEM42 exists. SYSTEM42: 
is thus selected as the system volume (denoted by the * beside the directory’s name). All of this 
selecting is done by the Pascal TABLE program as it configures the system each time you boot. 

Identification of Shared Peripherals 

Shared peripherals (printers and plotters) are connected to the SRM system controller through the 
controller’s internal HP-IB interface. To manage the use of the shared printers and plotters, the 
controller maintains special directories called “spooler directories.” 

You send information, in files, to a peripheral by placing the file name in the proper spooler 
directory. The SRM controller keeps track of the order in which files are sent to the directories and 
sends the files to the appropriate output devices in that order. Once you have placed a file in a 
spooler directory, your workstation is free to do other processing. 
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SRM’s Hierarchical Directory Structure 

The SRM system uses a hierarchical directory structure to organize its files. This directory structure 
looks like an inverted tree (see example below). The top level in the structure is called the “root.” 
Within the root are directories or files. Each directory may contain files or other directories. The 
drawing below shows a hierarchical directory structure. 



The directory SYSTEMS is a special directory used by Boot ROMs version 3.0 or later to automati¬ 
cally load operating or language systems. The SYSTEMS directory is discussed in more detail in the 
“System Startup” chapter. 

Note that, within the directory USERS, each of the three subordinate directories - ROGER, BOB 
and FRED - contains a file called work. Because each file and directory is uniquely specified by the 
list of directories from the root to the file, several files of the same name can exist in the directory 
structure (provided they are not within the same directory). 

Notation 

In specifying a location within the directory structure, the root is designated by a slash (/). To refer 
to a file or directory immediately under the root, for instance the directory USERS in the previous 
illustration, you would write: 

/USERS 

To specify a level further down the hierarchy, for instance, the directory ROGER under USERS, 
you would write: 

/USERS/ROGER 

and for yet another level: 

/USERS/ROGER/work 

As you can see, to specify a file, the list of directories to the target file must be specified. Directories 
in the list are separated by slashes (/). The sequence of names and slash delimiters is called a 
“directory path,” because it indicates the path one must follow down the hierarchy to get to a 
particular file or directory. 
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SRM Access Rights 

To control access to a file or directory, you can associate passwords with “attributes” that designate 
the type of access to be protected. Passwords may be assigned at the time the file or directory is 
created or with the Filer’s Access command. 

Any access right to which no password is assigned is public. Any user on the SRM may perform 
operations requiring the access right that is public, whereas only users supplying a correct password 
can perform operations that require the protected access. 

The attributes and the access rights controlled by their association with passwords or made avail¬ 
able to all SRM users by their remaining public are: 


Attribute 

Access to File 

Access to Directory 

READ 

operations that read from the 
file 

listing the directory’s con¬ 
tents 

WRITE 

operations that write to the 
file 

adding or modifying the 
directory’s contents (also 
need SEARCH to add to 
directory’s contents) 

SEARCH 

does not apply 

accessing the directory’s 
contents 

CREATELINK 

creating links to the file 

creating links to the direc¬ 
tory 

PURGELINK 

removing or renaming the file 

removing or renaming the 
directory 

MANAGER 

assigning, removing or chang¬ 
ing passwords on the file 

assigning, removing or 
changing passwords on the 
directory 


when password-protected, 
gives all other access rights as 
well 

when password-protected, 
gives all other access rights 
as well 


For example, SEARCH access is required on all directories along the path to a given file or 
directory. Suppose the password search-pass protects the SEARCH access on the directory 
ROGER (see illustration). To reach the directory MYSTUFF from the root, a user would have to 
include the password in the directory path specifier to MYSTUFF, as in: 

/USERS/ROGER<search_pass>/MYSTUFF 

If the SEARCH access capability on ROGER was public, any user could “pass through” ROGER 
without supplying a password. 

SRM access information is shown in the Filer’s Extended directory listing under the heading 
directory info. The one-letter identifiers (R for READ, 1*1 for WRITE, S for SEARCH, and so 
forth) indicate the public access rights on the files listed. 

The Pascal Workstation System manual discusses SRM access rights in more detail. 
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SRM Concurrent File Access 

The Pascal system defines three modes of access to shared files: EXCLUSIVE SHARED and 
LOCKABLE. 

EXCLUSIVE access mode allows only one workstation to open a file at a time. All files opened on 
the SRM are, by default, opened in EXCLUSIVE mode. 

A file whose access mode is SHARED may be opened by a number of SRM workstations for both 
reading and writing. This mode is primarily intended for reading from files, not writing to them. 
When two users write to the same file at the same time, results are unpredictable. 

The LOCKABLE access mode restricts the ability to read from and write to a file to the workstation 
that locks the file (using the file operations LOCK, WAITFORLOCK, and UNLOCK, as described in 
the Pascal Workstation System manual). The file remains inaccessible to other workstations until it 
is unlocked from the workstation at which it was locked. 

Files are typically locked and unlocked from within programs. The “Filer System” chapter of the 
Pascal Workstation System manual discusses concurrent file access in more detail. 

The current status for SRM files is shown in the Filer’s Extended directory listing under the heading 
di recto r y info. A current status of the files within the listed directory is shown as CLOSED, SHARED, 
EXCLUSIVE or CORRUPT. 

CORRUPT indicates that the disc lost power while accessing the file, possibly altering the file’s con¬ 
tents. 


Note 

If a file’s status is shown as CORRUPT, you should run the DSCK Utility 
program to check the directory structure and its integrity on the SRM 
system disc. Refer to the SRM Operating System Manual for details. 
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Duplicating Files in More Than One Directory 

To save disc space, you can use the Filer’s Duplicate link command to link a file into a directory 
other than its original location. Once a link has been established, the file looks to the Pascal system 
as though it is in the directory to which it is linked. 

For example, if you created a duplicate link from the file fl in the directory FRED to the directory 
MYSTUFF, you could specify the path to fl as: 

/USERS/ROGER/MYSTUFF/fl 
even though no copy of fl actually exists in MYSTUFF. 



This allows you to have access to files without making extra copies of them. 

If a file is purged from a directory to which it was linked, only the directory from which the file was 
purged loses access to that file. All other directories with links to the file can still find it. The disc 
space allocated to a file is only reclaimed when no directories have links to that file. 

The Duplicate link command is discussed with other Filer Commands in “The Filer” chapter of the 
Pascal Workstation System manual. 
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Using Your Pascal Workstation on SRM 

This section describes, through examples, some common procedures you’ll be using to operate 
your Pascal workstation on the SRM, including: 

• specifying locations within the hierarchical directory structure; 

• creating directories; 

• specifying files, directories and volumes; 

• protecting access to files and directories by assigning passwords; 

• using shared printers and plotters; 

• using Pascal Filer commands with SRM. 


Note About Key References 

Throughout this section, symbols for the keys used to enter commands 
are shown with each command. 

The ( ENTER) symbol denotes the key t o be u sed on either the 
HP 98203A or HP 98203B keyboard. The ( Return ] symbol denotes the 
key to be used on the HP 46020A keyboard. 

The HP 46020A keyboard is not supported by versions of the Pascal 
language system prior to 3.0. 


Moving Up and Down the Hierarchy 

It would be tedious to type a directory path every time you wanted to access a file. To avoid this, 
you can use the Filer’s Prefix and Unit directory (Udi r) commands to establish a directory as a 
reference point from which another location in the directory structure can be specified. A directory 
path to a file begins either from that reference point or from the root. To move about within the 
directory structure, you specify new reference points. 

The following discussion uses the directory structure illustrated below: 
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Using the Prefix Command 

Specifying a default volume tells the Pascal file system what volume name to use when none is 
specified with a file name. With SRM, the Pascal file system considers a directory a “volume.” 
Thus, you may designate a directory as the default volume and the system will perform file accesses 
directly within that directory or use the directory as the beginning of a path to another location in 
the directory structure. 

All volumes recognized by your Pascal workstation are listed when you use the Filer’s Volumes 
command. An example Volumes display for the directory structure illustrated above is: 

Molurnes on-1 ine : 

1 CONSOLE: 

2 SYSTERM: 

5 # ROGER: 

G PRINTER: 

45 * SYSTEM42: 

4G # SHARED: 

N#fi* §* - HU! 

In this Volumes listing, the directory ROGER is the current default volume. You may designate as 
the default volume any of the names that are shown in a Volumes listing with the # or * symbol 
beside them. Because these “volumes” are SRM directory names, you may also designate as the 
default volume any directory whose location can be specified through one of the names shown. 

For example, to designate the directory MYSTUFF as the default volume, you would: 

1. Type ( P ) 

The Filer prompts: 

Prefix to what directory? 

2. Type 

MYSTUFF [ENTER] or [ Return ] 
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With ROGER: as the current default volume, the system would assume the path began at ROGER. 
The new Volumes listing (illustrated below) would show MYSTUFF: as the default volume and unit 
#5 would now be associated with MYSTUFF: 

Mo 1umes on-line: 

1 CONSOLE: 

2 SYSTERM: 

G PRINTER: 

45 * SYSTEM42: 

4G # SHARED: 

tNfiPS* 4 twsiw* 



If you then wanted to list the contents of the directory MYSTUFF, you would: 

1. Type [ L ) for the Filer’s List directory command. The Filer prompts: 

List what directory? 

2. Type 

: (ENTER) or ( Return ) (notation that means “default volume”) 

Next, if you used the Prefix command, answering the Prefix to what di recto rv? prompt with: 
#46: (ENTER) or (Return) 

or 

SHARED: (ENTER) or (Return) 

your default volume would be at unit #46, not at unit #5. 

Mol time s on-1 i ne : 

1 CONSOLE: 

2 SYSTERM: 

5 * ROGER: 

G PRINTER: 

45 * SYSTEM42: 

SfllMiiii : 
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If you then used the Prefix command and responded to the prompt with: 

#5:/USERS/BOB (ENTER) or [Return] 

you would not only set the default volume to BOB: but you would also change the volume association for 
unit #5 from ROGER: to BOB:. 

Volumes on-line: 

1 CONSOLE: 

2 SYSTERM: 

| v f ! l III: 

.G.PRINTER: 

45 * SYSTEM42: 

46 # SHARED: 

id*? -tint 

The Unit Directory Command 

Another way to change the unit number/volume name association is with the Filer’s Unit directory 
{U d i r ) command. This association is referred to as setting a “working directory.” For example, 
typing: 

( U ) (The Filer prompts Set unit to what directory?) 

#4G:DATA (ENTER) or (Return) 

would make DA TA a working directory by associating unit #46 with that directory, but would not 
affect the default volume designation (Prefix is still BOB:). 

Volumes on-line: 

1 CONSOLE: 

2 SYSTERM: 

5 # BOB: 

G PRINTER: 

45 * SYSTEM42: 

tfgt y|| 

ilif lirfi .& || -ito $ 
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Now, because unit #46 is identified with the directory DATA, you would be able to use #46: and 
DATA: interchangeably with Filer commands. For example, to list the contents of DATA, you could 
respond to the List directory command’s List what directory? prompt with either: 

#46: (ENTER) or (Return) 

or 

DATA: (ENTER) or (Return) 

Take care when using the Unit directory command not to assign the default volume’s associated 
unit number to a name other than that of the current default volume. For example, if you were to 
type: 

( U ) ( The Filer prompts Set unit to what directory?) 

#5:/USERS/ROGER 

the resulting Volumes display would show: 

Volumes on-line: 

1 CONSOLE: 

2 SYSTERM: 

■MNNHHI 

G PRINTER: 

45 * SYSTEM42: 

46 # DATA: 

is » 608 s 

Even though BOB: would still be listed as the default volume, you would not be able use BOB: as 
the default volume, because BOB: is no longer an “on-line” volume. For instance, to list the 
contents of the default volume (directory), you would normally: 

1. Type ( L ) (The Filer prompts List what directory?) 

2. Type 

: (which is the notation indicating the default volume) (ENTER) or ( Return) 

But because, in this example, the Filer looks for a volume named BOB : that is associated with 
one of the unit numbers and doesn’t find it, it does not list the directory’s contents, as 
requested. 


Note 

You should not use the Unit directory command to change the associa¬ 
tion of #45: from your SYSTEMnn directory (the system volume). 
Doing so causes the system to lose access to the system files because the 
Pascal system looks for a workstation’s system files in its SYSTEMnn 
directory. 

You may, however, assign any of the on-line volumes as the default 
volume without affecting the system’s access to the system files. 
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Moving Up the Hierarchical Directory Structure 

A special directory name is provided for moving up the hierarchy. Two periods (.. ) can be used to 
denote the directory containing the current directory. For instance, if MYSTUFF: were the default 
volume, you could make ROGER: the default volume by answering the Prefix command s 
Prefix to what di recto ry? prompt with: 

.. [ENTER] or [ Return) 

To go up two levels, use the double-period twice, separated by a slash. For example to change the 
default volume from MYSTUFF: to USERS:, you would respond to the Prefix command s prompt 
with: 

,. /,. [ENTER] or [ Return ] 

The “ .. ” notation can be used to move all the way up the directory structure to the root, although, 
if you want to go directly to the root, using the slash (/) root identifier is easier. 

Creating Directories 

SRM directories are created by the Filer’s Make command. For example, to create a directory called 
KAREN in USERS you would: 

1. Type [ M ] 

The Filer prompts: 

MaKe File or Directory ? (F/D) 

2. Type [ D ] and specify where you want the directory located: 

#5-:/USERS/KAREN [ENTER] or [Return] 
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Specifying Files, Directories and Volumes 

Syntax of File or Directory Specification 

The syntax of a legal filespecification is given by: 

file-specification:: = [volume-id] [directory-path] file-name [“[“sizespec”]”] 

:: = volume-id 

In this notation, items between “ [ ” and “ ] ” are optional and quoted items appear literally. Note 
that, because a directory is a type of file, specification for directories is the same as that for files. 

A file-specification may appear in one of two forms. The first form consists of an optional 
volume-id followed by a colon ( : ), then an optional directory-path, then a file-name which is not 
optional, then an optional sizespec. 

An example of the first form is: 

#45:SYSTEMS/FILER 


The second form consists of a volume-id only. An example of the second form is: 

#5: 

Syntax of a Volume Identifier 

The volume identifier (volume-id) selects one of up to 50 logical units known to the Pascal file 
system. If no volumeJd is present, the volume used is the default volume (selected by the Filer’s 
Prefix command). Otherwise, the volume is specified in one of three ways: 

volume-id:: = “#”integer[password]“:” 


:: = name[password] 

In the first case, integer is a two-digit number from one to 50. For example, #23: is a valid volume 
identifier. The second case is a special form denoting the default volume. In the third case name is 
a sequence of characters. 

If the volume name of the SRM disc is DISC-ONE, the disc could be specified as: 

DISC.ONE: 


For a logical unit connected to an SRM system, the volume-id takes a special meaning The 
notation #5: refers to the working directory of unit number five. The notation #5: / refers to the root 
° f th ™ M d ' reCtory structure > with which unit number five is associated. The working directory for 
any SRM volume is selected by the Filer’s Prefix or Unit directory commands (refer to the “Moving 

Up and Down the Hierarchy” section earlier in this chapter), or the What command of the Main 
Command Prompt. 









87 


Passwords 

Passwords are sequences of up to 16 characters that govern the access rights to a file, a directory or 
the SRM volume (shared disc). Passwords are assigned to a file or directory either when it is created 
or by the Filer’s Access command. The SRM volume password is assigned through the SRM 
operating system’s RENAME or INITIALIZE commands (refer to the SRM Operating System 
Manual for details). 

Including the SRM disc’s volume password in a file-specification gives you unlimited access to all 
directories and files on the shared disc. The volume password overrides all other passwords in the 
system. Because of its power, this password is usually protected and used only with proper au¬ 
thority. 

You may use either of the forms for the volume password illustrated in the examples below: 

#5< uo1 passwo rd >:/USERS/ROGER/wo rk 
#5:< uo1 passwo rd >/USERS/ROGER/wo rk 

That is, the volume password may either immediately precede or follow the colon separator. 

Syntax of a Directory Path 

Directory paths are allowed in Pascal file-specification only when specifying files on SRM logical 
units. The syntax for a directory-path is: 

directory-path:: =[“/“] {directory-name [password]"/”} 
password:: = “<” word “>” 
directory-name:: = file-name 


The information between “ { ” and “ } ” may occur zero or more times. As you can see, there are 
two special directory names allowed with the SRM. The name “ . ” (a single period) refers to the 
current working directory. The name “ .. ” refers to the directory containing the working directory. 
Other names in a directory-path are directories along the path to the file or directory being 
specified. 

Note that a directory-path doesn’t appear by itself. It appears as part of a file-specification, with the 
file-name following the directory path. Examples of directory paths are: 

/. < PASSl >/ (denotes root, using password PASS1) 

/USERS/ROGER/ (denotes directory ROGER in USERS, where USERS is at the root) 

A specifier including both the directory-path and volume-id might appear as follows: 


#5:/WORKSTAT IONS/SYSTEM 13 
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SRM File or Directory Names 

The SRM system allows almost any file name. The Pascal system removes blanks and control 
characters from file names. 

The Pascal SRM Directory Access Method interprets the “ < ” character as the beginning of a 
password. All characters up to the next “ > ” character constitute the password. 

File Size Specification 

The last, optional part of a file-specification is the file size specifier ( sizespec ). Its syntax is: 
sizespec:: = “[’’integer “]” 

::= ”[*]” 

This specification takes effect only if a new file is being created with REWRITE, OPEN, APPEND or 
APPEND with OPEN. If the file already exists, the file system tries to make the file at least the size 
specified. The size is ignored for RESET. 

In the first form, the integer gives the number of 512-byte blocks to be allocated to the file. For 
instance Cl00] would cause allocation of 51,200 bytes. 

The second form [*] specifies that the file is to be allocated either half of the largest free space or 
the second largest free space, whichever is larger. If no size is specified when space for a new file is 
being allocated, the largest free area is assigned to the file. 

SRM extends the space allocation for files as needed. If data added to a file would cause the file to 
overflow its original space allocation, the system adds another block of memory (contiguous, if 
possible) called an “extent” to the file’s current space allocation. An extent’s size is equal to the 
original space allocation for the file. 

Allowable File or Directory Names 

What file names are allowed depends on the type of directory used on the volume in which the file 
resides. In other words, the directory organization determines the file name rules. 

File or directory names can consist of alphabetic letters and digits and the the hyphen ( -), 
underscore ( _ ), and period ( . ) characters. Blanks are removed from file names. 

In SRM directories, uppercase and lowercase letters are distinct. (ROGER is not the same as 
Roger.) You should not use the “ / ”, “ < ” and “ > ” characters, which have special meaning to 
the SRM system, in file or directory names. 
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Protecting Access to Files and Directories 

The Filer’s Access command allows you to change public access rights on your SRM files and 
directories. 

To use the Access command, 

1. Type ( A ) . The Filer prompts: 

Access riShts for what file? 

2. Type the file or directory specification. For example: 

#5:/USERS/ROGER/work 

If the file’s MANAGER access is password-protected, you must include the password in the 
file/directory specification. 

The Filer then prompts: 

Access: Listi M a k e t Remo vet Attributest Quit? 

3. You may then List the existing password(s) and the attributes to which each is assigned, 
Make new password/attribute assignments or Remove passwords. Attributes is a help feature 
that lists the attributes options. Quit returns you to the Filer prompt. 

The attribute option ALL is a shortcut notation for assigning a password to protect all access rights 
to a file or directory. For example, to assign the password all-rights to protect all access rights on the 
file work in the directory ROGER (assume all access rights on the directories in the path to work and 
on work itself are public), you would: 

a. Type ( M ) . The Filer prompts: 

Make password:attribute? 

b. Type: 

all_rishts:ALL (ENTER ) or ( Return) 

Now, any user wishing to access work for operations requiring any of the access rights (READ, 
WRITE, MANAGER, SEARCH, SEARCHLINK, PURGELINK) must include the password in the 
file specifier, for example: 

#5:/USERS/ROGER/wo rk< a 1 l_riShts > 

For more information, refer to the description of the Access command in “The Filer” chapter of the 
Pascal Workstation System manual (previously the Pascal User’s Manual). 












Using Shared Printers and Plotters 

Using a shared printer or plotter to output data requires you to place your data in a file in the 
spooler directory. Once the file is in the directory, the SRM operating system sends the file to the 
appropriate output device as soon as the device is free. 

For example, to print the text file named JOB-1. TEXT located by the SRM directory path #5:/ 
PROJECT-1 on the printer assigned to spooler directory named LP: 

1. Type ( F ) to enter the Filer from the Main Command prompt. 

2. Type { T ) to enter the Filer’s Translate mode. 

The Filer prompts: 

Translate what file? 

3. Type: 

#5: / PROJECT. 1/JOB. 1 .TEXT :/LP/JOB-1.ASC [ENTER] or [ Return] 

The file will be printed as soon as the printer is available. The . ASC ending on the file name tells the 
Filer to translate the information file into ASCII format, which is best handled by the SRM and its 
supported peripherals. 

In contrast to the SRM 1.0 system, the SRM 2.0 operating system allows non-ASCII files to be sent 
to the printing device as a byte stream. 


Note 

Any non-ASCII (such as .TEXT) file sent to the spooler is printed exactly 
as the byte stream sent. Unless you set up your non-ASCII file correctly, 
improper printer output or operation could result. Therefore, it is re¬ 
commended that you use only ASCII type files when spooling to a 
printer or plotter. 
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Using Pascal Filer Commands With SRM 

The following table summarizes the Filer commands either used exclusively with SRM or whose use 
has a special meaning for SRM. For full syntax and semantics information about these commands, 
refer to “The Filer” chapter of the Pascal Workstation System manual (previously the Pascal User’s 
Manual). 


Command 

Significance to SRM 

Access 

Changes the access rights (passwords) on a file or 
directory 

Bad-.secs 

Not valid for SRM 

Duplicate 

Links a file or files to a directory at another location in the 
directory structure 

K r u n c h 

Not valid for SRM 

Make 

Creates a directory within the SRM directory structure 

Prefix 

Sets or changes the default volume name 

Ud i r 

Changes the path specification for a unit directory 

Ze ro 

Not valid for SRM 
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System Startup 


Chapter 

3 


This chapter describes the procedures required to bring up an HP Series 200 workstation on the 
SRM for the first time. The procedures described in this chapter supplement the installation proce¬ 
dures described in the “System Installation” chapter of the SRM Operating System Manual and are 
to be performed by a system manager. 

The procedures described in this chapter are required for bringing up only the first of the language 
system’s workstations on the SRM for the first time and do not apply to adding subsequent 
workstations to the SRM system. 

This chapter is divided into two parts that describe the startup procedures for use from a BASIC 
SRM workstation and from a Pascal SRM workstation. Each part tells how to install the system 
software required to access and use the SRM with the language system and discusses the SRM 
directory structures recommended for use with workstations operating under that language system. 
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Initial System Startup 
From a BASIC SRM Workstation 

The following instructions describe the procedure for bringing up the SRM system on an HP Series 
200 BASIC 3.0 workstation for the first time. The instructions assume that the workstation has its 
own floppy disc drive. 

The “Initial System Startup From a Pascal SRM Workstation” section in this chapter gives instruc¬ 
tions for bringing up the SRM system on an HP Series 200 Pascal workstation. 

This section describes system setup procedures you perform from a BASIC workstation, including: 

• Creating the necessary directories on the system disc; 

• Copying operating system files to the system disc; 

• Creating files for automatic configuration at bootup (optional). 


Note 

This section reflects the startup procedures valid for use with BASIC 
3.0. The “SRM and BASIC 2.0” appendix gives the startup procedures 
appropriate for BASIC 2.0. 


Creating Directories on the System Disc 

This procedure follows initial installation of the SRM operating system on the system controller. You 
must have performed steps one through eight in the first section of the “System Installation” 
chapter, SRM Operating System Manual, before performing this procedure. 

The following steps load the BIN files necessary for accessing the SRM from an HP Series 200 
BASIC workstation and create the SYSTEMS and USERS directories on the SRM system disc. Use 
of the two directories is recommended to reduce the number of directories and files at the root level 
of the SRM directory structure. 


Note About Key References 

Throughout this section, symbols for the keys used to execute state¬ 
ments and commands are shown with each statement or command. 

The ( EXECUTE ) symbol denotes the execution key on either the 
HP 98203A or HP 98203B keyb oards (t he key on the HP 98203A 
keyboard is labeled ( EXEC ) ). The ( Return ) symbol denotes the execu¬ 
tion key on the HP 46020A keyboard. 

You may also use the (ENTER) key on these keyboards to execute com¬ 
mands. 
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(For Pascal Use) (Printer (Plotter 

Spooler) Spooler) 


(root) 


Recommended Root-Level Directories 


NOTE: For a description of the WORKSTATIONS directory, refer to the section 
on ‘‘Initial System Startup From a Pascal SRM Workstation" .later in this 
chapter. 

You create the SYSTEMS directory to hold operating system and bootup configuration files. The 
procedures for placing files in the SYSTEMS directory and for creating bootup configuration files 
are described in the next section. 


The USERS directory allows you to group working directories for the individual users (worksta¬ 
tions) on the SRM system. 

1. With your computer’s power OFF, insert the BASIC 3.0 SYSTEM DISC into the worksta¬ 
tion’s primary drive. Refer to the operating manual for the HP Series 200 computer or for the 
disc drive to determine which is the primary drive. 

Turn the computer’s power ON and allow the BASIC operating system to completely load, 
then remove the disc. 

2. Insert the BASIC 3.0 LANGUAGE EXTENSIONS DISC into the primary drive and type: 

LOAD BIN "SRM" ( EXECUTE ) or (Return) 

3. After the SRM BIN file is loaded, remove the LANGUAGE EXTENSIONS DISC from the 
primary drive, insert the BASIC 3.0 DRIVERS DISC into the same drive, and type: 

LOAD BIN "DC0MM" ( EXECUTE ) or (Return) 

4. To establish communications with the SRM, type: 

MSI ":REM0TE" f EXECUTE ) or ( Return ) 

which places you at the root of the SRM directory structure. You may wish to verify your 
location within the directory structure by typing: 

CAT ( EXECUTE ) or (Return) 

The header for the resulting catalog listing should indicate the remote msus as shown in the 
example below: 


: REMOTE 21 t 0 remote msus 

LABEL: SRM 

FORMAT: SDF 

AVAILABLE SPACE: 54096 


5. Create the SYSTEMS directory by typing: 


CREATE DIR "SYSTEMS" [ EXECUTE ) or ( Return) 
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6. Create the USERS directory by typing: 

CREATE DIR "USERS" ( EXECUTE ) or (Return) 

7. Leaving the workstation connected to the SRM under the BASIC operating system, return to 
Step 9 in the “System Installation” chapter of the SRM Operating System Manual, and 
proceed with installing the SRM operating system file, SYSTEM_SRM, in the SYSTEMS 
directory. 

The following discussion and examples assume that SYSTEM_SRM is the first system installed on 
the system disc and in the SYSTEMS directory. Besides installing the SRM operating system on the 
system disc, you may wish to: 

• create the spooler directories; 

• copy other operating system files into the SYSTEMS directory; 

• create workstation bootup configuration files (optional); 

• create individual working directories within the USERS directory. 

Setting up spooler directories is discussed in the “System Installation” chapter of the SRM Operat¬ 
ing System Manual. Use of the SAVE command to save the spooler configuration and node names 
creates and updates the file, CONFIG-SRM in the SYSTEMS directory (also discussed in the 
“System Installation” chapter of the SRM Operating System Manual). 

The next sections discuss how to design and implement a bootup scheme for workstations on your 
SRM system. 


Planning the SYSTEMS Directory 

Creating the SYSTEMS directory allows you to concentrate all operating system software and 
configuration files in a single directory on the SRM system disc. 

You will determine your SYSTEMS directory’s contents and structure according to the SRM 
system’s application within your environment. Your decision depends upon the operating system 
software your users require and upon the powerup scheme you wish to implement for the worksta¬ 
tions on your network. 

In general, environments supporting BASIC workstations fall into one of two categories: 

• those in which all or most of the users operate primarily under the BASIC operating system; 

• those supporting users of several operating systems. 

In the first environment, you may want all workstations to boot the BASIC operating system at 
powerup, whereas in the second, you may want each workstation to boot the operating system of 
its user’s choice. 
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Note 

Only HP Series 200 computers with Boot ROM version 3.0 or later can 
boot from the SRM. Upon powerup, the computer should display 
BOOT ROM 3 . 0. If no boot ROM message is displayed, the computer has 
an earlier version boot ROM. If B00TR0M 3.0L is displayed, the compu¬ 
ter’s boot ROM is a subset of the 3.0 boot ROM and does not support 
automatic booting from SRM. 


The following sections help you plan your SYSTEMS directory to accommodate the workstations 
capable of booting from the SRM. Workstations with ROMs that do not support automatic booting 
must boot from local mass storage. 

If BASIC is the Predominant Operating System 

The order of the files in the SYSTEMS directory determines, to some extent, the operating system 
software used by the workstation boot ROM at powerup. Unless the workstation operator interrupts 
the bootup procedure to select a system, the boot ROM loads the first bootable system file (a file of 
type SYSTM whose name begins with SYS) from the SYSTEMS directory into the workstation. 

If all users on your SRM system require the same basic set of BIN files, you may wish to create a 
unique BASIC system file for use at powerup. Refer to the BASIC Language Reference manual for 
details on creating this file (see the STORE SYSTEM keyword). Your SYSTEMS directory would 
look similar to the one illustrated below: 



(root) 


where UNIQUE is the name you assign your customized BASIC system file. Note that you must 
include the SRM and DCOMM BIN files in that file for the workstations to communicate with the 
SRM system. Refer to the section on “Placing System Files in the SYSTEMS Directory” for more 
information on which BIN files to include. 
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If each user requires a unique set of BIN files, you may prefer to keep separate BIN files in the 
SYSTEMS directory and create autostart files for individual workstations. Your SYSTEMS directory 
would look similar to the list below: 



where each AUTOSTnn is an autostart PROG file specifying the initial BASIC system operations to 
be performed for a specific workstation on the network. The AUTOST file specifies the default set of 
operations, used for workstations for which no unique autostart file exists. 

(Note that AUTOST is at the root level of the SRM directory structure, not within SYSTEMS.) Refer 
to the section on “Creating Autostart Files for Use by the BASIC 3.0 System” for further details. 

If a Variety of Operating Systems are Used 

If you want each workstation on the network to power up in the operating system of its user’s 
choice, you may construct the SYSTEMS directory in either of two ways. 

A workstation user can always select an operating system from among those available to the 
workstation. If a user presses any key immediately after the powerup display indicates that the boot 
ROM has recognized the keyboard, the ROM lists all available bootable systems and waits for the 
user to select a system. Refer to the BASIC User’s Guide for further details on explicit system 
selection at powerup. 

If you want to give users a choice of systems by this method, the order of the systems files in your 
SYSTEMS directory is unimportant, except that the boot ROM will use the first bootable system file 
listed in the directory if the user does not interrupt booting to select a system. A bootable system file 
is a file of type SYSTM whose name begins with SYS. 
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For example, if the files in your SYSTEMS directory were ordered as listed as below: 



if a workstation user on the SRM system did not specifically select an operating system at powerup, 
the boot ROM would boot SYSTEMJ3A3 in the workstation, along with BIN files specified in the 
appropriate AUTOST or AUTOSTnn file. Users could select another system, such as Pascal 
(SYSTEM_P) instead by interrupting the booting process as described above. 

To automate the process, you may use the BASIC Loader Utility (also called the “secondary 
loader”), which selects the operating system for the user. Use of the Loader Utility requires you to 
place the BASIC Loader Utility system file (SYSTEM_LD) in SYSTEMS as the first bootable system 
file. The Loader Utility requires special configuration files specifying the system to be selected, so 
you must also include those files in the SYSTEMS directory. 
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The next sections explain the Loader Utility method in more detail. If you use this method, your 
SYSTEMS directory should look similar to the list below: 



where each CONFIG_LDnn represents a configuration file specifying the system to be booted in a 
specific workstation on the network, and CONFIG-LD is the configuration file specifying the system 
to be booted in workstations for which no unique file exists. Refer to the section on “Creating 
Configuration Files for Use by the Loader Utility” for further details. 

If autostart (AUTOST or AUTOSTnn) file(s) are in the directory also (as in the illustration), and the 
CONFIG-LD file specifies the BASIC 3.0 system, upon being loaded, the BASIC system automati¬ 
cally performs the procedures specified in the autostart files. 

Note that, with this method, the order of all files in the SYSTEMS directory, other than 
SYSTEM-LD, is unimportant. 
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Placing System Files in the SYSTEMS Directory 

You may now place files in the SYSTEMS directory in the order required for your chosen worksta¬ 
tion bootup scheme (as discussed in the previous section). This section lists the system files required 
for BASIC use on SRM, and illustrates the procedure for copying individual files from the BASIC 
discs to the SYSTEMS directory. 

System Files Important for BASIC Use on SRM 

The table below shows some of the operating system files you may wish to copy to the system disc, 
the importance of each file to SRM use, and the disc containing the file: 


System File 

Necessary if you wish to use: 

On the disc labeled: 

DCOMM BIN file 

Shared Resources (SRM) 

DRIVERS 

GRAPH BIN file 

PLOTTER IS <remote file> 

SYSTEM$(“PLOTTER IS”) 

LANGUAGE EXTENSIONS 

I/O BIN file 

PRINTER IS (with EOL, WIDTH parameters) 
RESET 

LANGUAGE EXTENSIONS 

KBD BIN file 

LOAD KEY 

STORE KEY 

RE-STORE KEY 

LANGUAGE EXTENSIONS 

MS BIN file 

CAT (with options) 

LANGUAGE EXTENSIONS 

PDEV BIN file 

LOADSUB FROM 

LANGUAGE EXTENSIONS 

SRM BIN file 

Shared Resources (SRM) 

LANGUAGE EXTENSIONS 

TRANS BIN file 

TRANSFER 

LANGUAGE EXTENSIONS 

SYSTEM_BA3 

BASIC Operating System 

BASIC 3.0 SYSTEM 

SYSTEM_LD 

BASIC Loader Utility 

UTILITIES LIBRARY 2 


Example: Placing the Loader Utility System File 
in the SYSTEMS Directory 

To copy system files to the SYSTEMS directory on the SRM system disc, follow the procedure 
discussed below, substituting the name of the appropriate system file in the COPY command, and 
using the discs listed in the table above. 


You should copy the files in the order in which they are to be placed in the SYSTEMS directory. 
This order is determined by your chosen workstation powerup scheme, as discussed in the section 
on “Planning the SYSTEMS Directory.” 

Working from the BASIC workstation you used to create the SYSTEMS directory, you would copy 
the BASIC Loader Utility program (shipped on the disc labeled UTILITIES LIBRARY 2) to the 
SYSTEMS directory by typing: 

COPY "SYSTEM-LD: <msus>" TO "SY5TEMS/SYSTEM-LD" ( EXECUTE ) or (Return) 


where <msus> is the mass storage unit specifier for the device from which you are copying 
SYSTEM.LD. If you are copying SYSTEM-LD from disc labeled UTILITIES LIBRARY 2, the <msus> 
specifies the disc drive containing the disc. 

Refer to the “Data Storage and Retrieval” chapter of the BASIC Programming Techniques manual 
for details on msus. 
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Creating BASIC Workstation Bootup Configuration Files 

This section describes how to create the files necessary to allow the BASIC workstations that are 
capable of booting from the SRM to boot from the SRM in a specific configuration. Two types of 
configuration files can be used for automatic configuration, either singly or in combination: 

• Configuration file(s) for use by the Loader Utility. Using the CONFIG-LD files, the Loader 
Utility selects the operating system for the boot ROM to install in the workstation. 

• Autostart file(s) for use by the BASIC 3.0 operating system. The AUTOST files specify some 
initial actions to be performed by the operating system, such as loading BIN files. 

Creating Configuration Files for Use by the Loader Utility 

If you want workstations on your SRM system to automatically boot selected systems, the BASIC 
Loader Utility system file, SYSTEM_LD should be the first bootable system file stored in the 
SYSTEMS directory. Use of the Loader Utility is not necessary if all workstations are to boot the 
same system at powerup. 

For use with the SRM, you create two kinds of bootup configuration files -- a default file and a 
configuration file unique to a workstation. The Loader Utility uses the default configuration file for 
any workstation for which a unique configuration file does not exist. 

The Loader Utility recognizes the default configuration file as CONFIG-LD, and individual worksta¬ 
tion configuration files as CONFIG_LDnn, where nn is the workstation’s assigned node number. 
For node numbers 0 through 9, nn is specified as a single digit. The Loader looks for its configura¬ 
tion files in the SYSTEMS directory. 

Each configuration file is an ASCII file containing only the name of the operating system file to be 
loaded by the boot ROM at powerup. Any further operations, such as loading BIN files, must be 
specified in an autostart file. 

The example program below creates the ASCII file CONFIG-LD7 in the SYSTEMS directory to 
specify the BASIC 3.0 system as the bootup system for an SRM workstation at node number 07. 

10 CREATE ASCII "/SYSTEMS/C0NFIG_LD7" . 1 
20 ASSIGN @Fi1ename TO "/SYSTEMS/C0NFIG-LD7" 

30 OUTPUT @Fi1enamei "SYSTEM-BA3" 

40 ASSIGN @Fi1ename TO * 

50 END 

For more details on creating the loader configuration files, refer to the BASIC Loader Utility 
Manual. 
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Creating Autostart Files for Use by the BASIC 3.0 System 

Any workstation booting the BASIC 3.0 system may have an autostart file instructing the system to 
perform certain operations upon powerup. Autostart files are PROG files (whose names begin with 
AUTOST), which the BASIC system automatically loads and executes. An autostart file may include 
instructions to load BIN files (for example, LOAD bin "SRM"). 

For more details on creating autostart files, refer to the BASIC User’s Guide or the “Entering, 
Running and Storing Programs” chapter of the BASIC Programming Techniques manual. For use 
with the SRM, you may create two kinds of autostart files - a default file and an autostart file unique 
to a workstation. The BASIC system uses the default file for any workstation for which a unique 
autostart file does not exist. 

When a workstation boots BASIC 3.0 from the SRM system disc, the BASIC system looks for a file 
named AUTOSTnn in the SYSTEMS directory, nn is the node number assigned to the workstation, 
with node numbers 0 though 9 designated by a single digit (for example, AUTOST6). If a worksta¬ 
tion’s autostart file does not exist, the system then looks for the default file named AUTOST at the 
root level of the SRM directory structure. Failing to find either, the system waits for the first 
command from the keyboard. 
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Initial System Startup 
From a Pascal SRM Workstation 

This section explains how to configure workstations to access and boot Pascal from an SRM system 
disc using three methods of modifying the standard configuration: 

• Copying and re-naming files; 

• Adding modules to INITLIB; 

• Modifying the TABLE program (optional). 

This section tells what to do the first time you set up the first Pascal workstation to access an SRM 
system. It should not be repeated for every workstation you set up. Once this procedure is com¬ 
plete, the SRM will be accessible to all Pascal workstations on the SRM system. 


Note About Key References 

Throughout this section, symbols for the keys used to enter commands 
are shown with each command. 

The ( ENTER) symbol denotes the key t o be u sed on either the 
HP 98203A or HP 98203B keyboard. The ( Return ) symbol denotes the 
key to be used on the HP 46020A keyboard. 

The HP 46020A keyboard is not supported by versions of the Pascal 
language system prior to 3.0. 


Before You Begin 

Before you begin the procedures outlined in this section, you should be aware of the following 
points: 

Prerequisites 

This procedure assumes: 

• The person designated as the “SRM system manager” will perform the procedure. 

• Your SRM hardware has been installed and tested as prescribed in the SRM Hardware Installa¬ 
tion Manual. 

• Each workstation in your SRM configuration has a unique node number. You will need to 
know the node numbers assigned to the workstations when your SRM system was designed 
and installed. 

Boot ROM Versions 

If you have an HP Model 216 Computer with Boot ROM 3.0L, you must boot from a local disc 
drive. The SRM can be used only after normal booting is complete. Similarly, if you have an HP 
Model 226 or 236 computer with a boot ROM whose version number is less than 3.0, you must 
boot from the internal 5.25-inch flexible disc drive. In either case, you may want to make a backup 
copy of the original BOOT: disc, as you will be modifying the INITLIB file on that disc. 


Computers equipped with Boot ROM version 3.0 or later can boot directly from the SRM. 
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SRM Version 1.0 Operating System Parameters 

Four parameters must be set when the SRM 1.0 operating system is initially configured. (With SRM 
2.0, they are set automatically.) Appropriate values for these parameters when using Pascal work¬ 
stations with SRM 1.0 are: 


Parameter 

Recommended Value 

IOBUFFERS 

At least 5 per workstation in the 
configuration (for example, 40 buf¬ 
fers for 8 workstations) 

DISC BUFFERS 

50 

TASKS 

2 

FILES 

10 or 12 open files per workstation 
in the configuration 


Planning Your SRM Directory Structure 

The first time you access an SRM system from a workstation, you need to set up certain directories 
on the SRM system disc. These directories have special functions, as described in the following 
paragraphs. 



(Printer (Plotter 


(root) 


Spooler) Spooler) 


Recommended Root-Level Directories 

This suggested directory structure calls for a directory named WORKSTATIONS in the root of the 
SRM directory structure, which is to contain several directories for Pascal workstation system files. 
These directories include: 

• SYSTEM, which is to contain copies of all the Pascal system files, such as the Compiler, Filer 
and Editor. 

• A SYSTEMnn directory for each workstation on the SRM system, where each rtn corresponds 
to a workstation’s node number. 

• TEMP_FILES, within which all temporary files are kept. 
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To allow each workstation in an SRM configuration to boot a unique system and have its own 
system volume, you may wish to establish a unique SYSTEM directory for each node number. 



Recommended Contents of the WORKSTATIONS Directory 

For example, the illustration shows SYSTEM directories for workstations on nodes 08 and 14. 

If a workstation has a local high-performance mass storage device, you may wish to use that device 
as the workstation’s system volume. In fact, the automatic configuration process selects a high- 
performance mass storage (if one is present) as the system volume. The suggested directory 
structure uses separate directories for each node, with the option to copy frequently used files, such 
as the Editor and Compiler, from the SRM system disc onto local high-performance system 
volumes. Then, when a workstation boots the system, those files can be accessed locally with 
correspondingly greater speed. 

Each workstation’s SYSTEM directory should provide access to all the system files normally used 
by the workstation. For some files, such as the Compiler, duplicate links to a single copy of the file is 
preferable to making individual copies of the file for each workstation. The Filer’s Duplicate link 
command can be used for this purpose, as described in the section, “Duplicating Links to System 
Files,” later in this discussion. 

A workstation’s SYSTEM directory can also contain the files that “personalize” a workstation, such 
as customized copies of LIBRARY, INITLIB, AUTOSTART, and so forth. 

This directory structure makes booting a smooth and automatic process. With Boot ROM version 
3.0 or later (but not 3.0L), a workstation can boot from the SRM with the system to be booted 
being selected by name at powerup. Thereafter, the workstation looks for the necessary files in its 
SYSTEM directory (SYSTEMnn). If the workstation can’t find INITLIB in its SYSTEMnn directory, 
it looks in SYSTEM. 

If a workstation boots from the SRM system disc or has no local hard disc on-line, the system 
volume is identified as unit #45 (prefixed to the workstation’s SYSTEMnn directory) and the 
default volume is #5 (another SRM volume, prefixed to the root of the SRM directory structure). 
Even if the SRM system disc is not chosen as the system volume (using the scheme above), it will 
still be accessible through units #5 and #45. 

The WORKSTATIONS directory should also contain at least one more special directory called 
TEMP_FILES. All temporary files are created in this directory, and are removed when no longer 
needed. If you don’t create this directory, the first workstation to need it will do so. Consequently 
the directory WORKSTATIONS should not be write-protected unless directory TEMP_FILES has 
already been created. 
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To provide users with a private directory to use as their default volume, you may create a directory 
called USERS in the root, and within USERS, a private directory for each individual. After booting, 
users may set the current working directory for their unit #5 to their private directory. A modified 
TABLE program or an AUTOSTART file can be created to do this automatically. Refer to the 
chapter on “Setting Up Your Environment” in the Pascal User’s Guide for information on creating 
AUTOSTART files. This keeps the root from getting cluttered. 

Overview of SRM Installation 

Configuring your system to access SRM is not a hard or complicated operation, but it is important 
that you follow the subsequent procedures in exact detail. Because you are less likely to make 
mistakes if you understand what’s going on, here is an outline of what you will do. 

1. Install driver modules DATA_COMM and SRM by executing them (they are programs that 
install themselves automatically). 

2. Execute the TABLE auto-configuration program. When TABLE is executed while the 
DATA_COMM and SRM driver modules are installed, it finds the SRM system and assigns 
unit #5 to the SRM system disc. 

3. If they are not already on the SRM system disc, create the SYSTEMS and WORKSTATIONS 
directories at the root of the SRM directory structure, and the SYSTEM directory in the 
WORKSTATIONS directory. 

4. Copy the system boot file (SYSTEM_P) to the SYSTEMS directory. Copy the rest of the 
Pascal system files to the SYSTEM directory. (The boot ROM expects to find the Pascal 
system in these directories.) 

5. Use the Librarian to create (on the SRM system disc) a new INITLIB file that contains the 
DATA_COMM and SRM modules, and then replace the existing INITLIB with this new one. 
(If you have Boot ROM version 3.0 or later, you will be replacing the INITLIB in the 
SYSTEM directory. With earlier version boot ROMs and Boot ROM 3.0L, you will be 
replacing the INITLIB on the BOOT: disc.) 

6. Re-boot the computer, and verify the new configuration. 

7. (Optional) Modify the TABLE program to assign additional unit numbers to the SRM system. 

Installing the SRM Driver Modules 

First, install the DATA_COMM module. The file is on the CONFIG: disc that is supplied with your 
system. Although you may have already copied the file onto another volume, such as a local hard 
disc, this example assumes that you will be loading and executing DATA_COMM from the 
CONFIG: disc. 

Execute the file by pressing ( X ) at the Main Command Level. The system prompts: 

Execute what file? 

Enter this file specification: 

C0NFIG:DATA_C0MM. ( ENTER) or [ Return) 

Be sure to include the trailing period to suppress the “.CODE” suffix. 

Install the SRM module similarly. SRM is also on the CONFIG: disc. 
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Re-Configuring with TABLE 

Execute the TABLE program, which is on the BOOT: disc supplied with your system. Press ( X ) , 
then answer the Execute what f i 1 e? prompt with: 

BOOT: TABLE. (ENTER) or ( Return ) 

Again, be sure to include the trailing period. 

When the program has finished, you can use the Filer’s Volumes comma nd to s ee that un it #5 i s 
assigned to the SRM system disc. From the Main Command Level, press ( F ) and then ( V ) . 
Here is a typical display: 

Volumes on-line: 

1 CONSOLE: 

2 SYSTERM: 

3 # BOOT: 

5 * SRM: 

G PRINTER: 

Prefix is - SRM: 

If the volume name of the SRM system disc (in this example, SRM) is not shown in the display, 
re-execute the DATA_COMM, SRM, and TABLE programs. You may have done something wrong 
in that process. 

If the Filer’s Volumes command still does not recognize the #5: volume, check to see whether the 
SRM hardware is properly configured and installed. For instance, the (unmodified) TABLE prog¬ 
ram expects the SRM interface in your computer to be set to select code 21. 

If that does not work, then you should refer to the troubleshooting sections of the SRM Operating 
System Manual. 

Creating Required Directories 

To create the directories on your SRM, follow the examples below: 

To create the WORKSTATIONS directory, use the following Filer sequence: 

1. Press ( M ) for the Make-directory command. The Filer responds with this prompt: 

Make file or directory (F/D) ? 

2. Press ( D ) to make a directory. The Filer responds with the prompt: 

M a K e directory (valid only for SRM type units) 

Make what directory? 

3. Respond by typing: 

#5: /WORKSTATIONS (ENTER) or ( Return ) 
to which to the Filer should reply: 

Directory is 'WORKSTATIONS' correct ? (Y/N) 

4. Press ( Y ) . The directory is created, and the following message is displayed: 


Directory WORKSTATIONS wade* 
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If the computers in the SRM configuration have Boot ROM version 3.0 or later, which allows 
booting from the SRM, you will also want to create a directory called SYSTEMS at the root. For 
more information about the SYSTEMS directory, refer to the section on “Planning the SYSTEMS 
Directory” earlier in this chapter. 

Repeat the steps above, answering the Make what directory? prompt with: 

#5:/SYSTEMS (ENTER) or (Return) 

You may also wish to create the USERS directory at the root as you did SYSTEMS. 

Next, create directory SYSTEM under WORKSTATIONS to store the master copy of all Pascal 
system programs, such as the Compiler. To reduce the amount of typing involved, you can make 
WORKSTATIONS the current working directory for unit #5. 

5. Press ( P ) for the Prefix command. The Filer responds: 

Prefix to what directory ? 

6. Answer by typing: 

#5: /WORKSTATIONS (ENTER) or ( Return) 
to which the Filer responds: 

Prefix is WORKSTATIONS: 

To create the SYSTEM, SYSTEMnn and TEMP_FILES directories, use the same steps you used to 
create the WORKSTATIONS directory, answering the Make what directory? prompt with the 
name of the directory to be created. (You need not specify #5:/WORKSTATIONS.) Note that creating 
TEMP_FILES is necessary only if you plan to write-protect the WORKSTATIONS directory. 

Copying the System Files to SRM 

You may now place the required files into the new directories: 

1. To prefix the current working directory to SYSTEM, press ( P ) for the Prefix command. 

2. Type: 

#5:/ WORKSTATIONS/SYSTEM (ENTER) or ( Return) 

To which the Filer responds: 

Prefix is SYSTEM: 

3. Insert the BOOT: disc in the drive y ou have been using and copy all the files on it into the 
new working directory. Press ( F ) for the Filecopy command. The Filer prompts: 

Fi1e c o p y what file? 

4. Specify that you want all files on the BOOT: disc to be copied by using the = wildcard as 
follows: 

BOOT : = »$ (ENTER) or ( Return ) 

The Filer copies the files one after another. 

Repeat the above operation for each of the Pascal system discs (ACCESS:, SYSVOL:, and so 
forth). After this is done, the SYSTEM directory contains the entire Pascal Workstation system. 
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Duplicating Links to System Files 

To make the system files available in the SYSTEMnn directory of each workstation, use the Filer’s 
Duplicate Link command: 

1. Press ( D ) . 

The Filer responds: 

Duplicate link (valid only for SRM type units) 

Duplicate or Move ? (D/M) 

2. Press ( D ) . The Filer prompts: 

Dup_link what file? 

3. Answer by typing: 

? t#5: / WORK ST AT I ONS/SYSTEMnn/ $ (ENTER) or ( Return ) 

substituting a two-digit node number for nn each time (a leading 0 is required for single-digit 
node numbers). The “?” wildc ard tells the Filer to ask if you want links to each file in the 
source directory. Answer ( Y ) for every file except AUTOSTART and SYSTEM_P. 

The Duplicate link displays each file name as the links are made. 

The last detail is optional. If any of the workstations in the SRM system have Boot ROM version 3.0 
or later and you want them to boot from the SRM instead of using local mass storage, you need to 
put a copy of the Pascal system boot file in the SYSTEMS directory (not in the SYSTEM directory 
under WORKSTATIONS). The system boot file (SYSTEM_P) is on the BOOT: disc shipped with 
the system. (You may have already made a backup copy of that disc.) The Duplicate link command 
links the SYSTEM_P file to the SYSTEMS directory. 

1. Press ( D ) for the Duplicate link command. 

The Filer responds with: 

Duplicate link (valid only for SRM type units) 

Duplicate or Move ? (D/M) 

2. Press ( D ) . 

The Filer prompts with: 

Dup.link what file? 

3. Respond by typing: 

#5: / WORK ST AT I ONS/SYSTEM/SYSTEM. P .#5 : /SYSTEMS/* (ENTER) or ( Return) 

Once the system files are all in the appropriate directories on the SRM system disc, any workstation 
using the BOOT: disc you create in the next procedure will be able to access the SRM via logical 
units #5 and #45. If a workstation has high performance local mass storage such as a fixed disc, 
that workstation’s system volume will be on the local mass storage. Otherwise the SRM directory 
#45:/WORKSTATIONS/SYSTEMnn will be the the system volume. 

You may wish to also create a working SRM directory within the USERS directory for each user in 
addition to the SYSTEMnn directories for each workstation. A user may then use unit #45 for his 
system volume and #5 will be prefixed to his working directory. 
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SRM as the System Volume 

You may now designate the workstation’s SYSTEMnn directory as its system volume. You first 
need to re-execute the TABLE program to assign unit #45: to this directory. Press ( X ) at the 
Main Command Level, and enter this file specification: 

/WORK ST AT IONS/SYSTEMnn/TABLE. (ENTER) or (Return) 

replacing nn with the node number of the workstation. Don’t forget the period. 

Now you can execute the Newsysvol command (at the Main Command Level) and specify #45: as 
the unit number. You may use the What command to verify that all of the subsystems (EDITOR, 
FILER, etc.) were found in the workstation’s SYSTEMnn directory. Designating SYSTEMnn as the 
system volume allows yo u to ac cess the SRM copies of the Pascal subsystems from the workstation 
by pressing keys such as ( E ) for Editor, and so forth. 


Note 

You should not change the prefix on unit #45 once it is assigned to 
SYSTEMnn. 


Adding Modules to INITLIB 

This procedure adds the DATA_COMM and SRM modules (shipped on the CONFIG: disc) to 
INITLIB (shipped on the BOOT: disc), creating a new INITLIB on the SRM system disc that 
includes the drivers required for the SRM. 

1. At the Main Command Level, press ( L ) to load the Librarian (note that the Librarian 
should be loaded from the SRM system disc). 

2. When you see the Librarian’s prompt line at the top of the CRT, press ( 0 ) to specify the 
name of the (Output) file the Librarian will be creating (called INITNEW). 

3. Type: 

#5: / WORK ST AT IONS/SYSTEM / INITNEW (ENTER) or ( Return ) 

4. Press ( I ) so you can specify an Input file, then type: 

#5:/ WORKSTATIONS/SYSTEM /INI TUB. (ENTER) or (Return) 

Be sure to type the period after the word INITLIB in this command (to suppress the .CODE 
suffix). The Librarian responds by showing INITLIB as the name of the input file. 

5. Near the bottom of the CRT a line appears that says: 

M input Module: KERNEL 

Press ( T ) to transfer this module to the Output file. After a few moments, the name of a 
new module (kbd) appears. Each time a new module name appears, press ( T ) to move it 
to the output file. You should continue copying modules until the name last appears. Do 

not copy the module LAST yet. 

6. Now you must get the required SRM and DATA_COMM drivers and include them in 
INITNEW. Press ( I ) and type: 

#5:/W0RKSTATI0NS/SYSTEM/DATA_C0MM, (ENTER) or (Return) 

Don’t forget the period after the name. 
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7. When the module name DATA.COMM appears near the bottom of the screen, press ( A ) to 
tell the Librarian to transfer the module to the Output file (INITNEW). 

8. Press ( I ) and type: 

# 5 :/WORKSTATIONS/SYSTEM/SRM. (ENTER) or ( Return ) 
again, being sure to include the period. 

9. When the module name SRM appears on the bottom of the screen, press ( A ) to transfer 
SRM to INITNEW. 

10. Press ( I ) and type: 

#5: / WORK STATIONS/SYSTEM / IN I TUB. C ENTER) or (Return) 

11. When module nam e KERN EL shows up near the bottom of the screen, select module LAST 
instead by pressing ( M ) , then typing: 

LAST (ENTER) or ( Return ) 

12. Transfer LAST to INITNEW by typing ( T ) . 

13. You now have all the modul es in y our new library. “Keep” INITNEW by typing ( K j , then 
quit the Librarian by typing ( Q ) . 

Replacing INITLIB 

Where you place the new version of INITLIB depends on which boot ROM is in your machine. 

• If you have Boot ROM version 3.0 or later (but not 3.0L), you will probably want to leave the 
modified INITLIB in the SYSTEM directory, where it will be found automatically when work¬ 
stations boot from the SRM. 

• If you have an earlier version boot ROM or Boot ROM 3.0L, you need to replace the INITLIB 
on the BOOT: disc with the new INITLIB (INITNEW) because these boot ROMs cannot boot 
directly from the SRM — they must use the BOOT: disc. 

With Boot ROMs Version 3.0 and Later 

1. Use the Filer’s Change command to re-name the existing INITLIB (in /WORKSTATIONS/ 
SYSTEM) to something like OLDINITLIB. 

2. Use the Change command again to re-name the INITNEW file to INITLIB. 

3. Re-boot your workstation to verify that the new INITLIB file works correctly. 

4. Use the Filer’s Duplicate link command to link the new INITLIB to the SYSTEMnn director¬ 
ies of the workstations that will be booting from the SRM. (Or you may make custom 
INITLIB files for each workstation.) 

With Earlie r Versi on Boot ROMs 

1. Press ( F ) to invoke the Filer. 

2. Put the spare copy of the BOOT: disc (not the original) into a drive. Press ( R ) for the 
Remove command. The computer responds with: 

Remove what file? 

3. Answer by typing: 

BOOT: INITLIB (ENTER) or ( Return ) 


Note that there is no period after the file name this time. 
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4. Press ( K ) (Krunch) to pack all the remaining files on the disc to make the maximum 
amount of room for the new INITLIB. The Filer prompts: 

Crunch what directory? 

5. Answer by typing: 

BOOT: (ENTER) or ( Return) 

The Filer prompts: 

Crunch directory BOOT ? (Y/N) 

6. Answer by pressing ( Y ) . The Filer then prompts: 

Crunch of directory BOOT in proSress 
DO NOT DISTURB!! 


Note 

If you interfere with the disc before the crunch operation completes, you 
will ruin the data on the disc. You will certainly have to recopy it from 
the original BOOT: and you may have to re-initialize it. 


After the crunch is complete, the Filer prompts: 

Crunch completed 

7. You may now Filecopy the INITNEW file onto the spare BOOT: disc and change the file’s 
name to INITLIB. To do so, insert the spare BOOT: disc into a disc drive and press ( F ) for 
the Filecopy command. 

Filecopy what file? 

Answer: 

#5:/WORKSTATIONS/SYSTEM/INITNEW.CODE (BOOT: INITLIB (ENTER) or ( Return) 

When the Filecopy finishes, you have a BOOT: disc on which the INITLIB contains the SRM 
drivers. 

8. Verify that the new INITLIB works by re-booting your system from that disc. 

Each Pascal workstation in the system with earlier (or 3.0L) boot ROMs must boot using an 
INITLIB that includes the SRM driver software. You may wish to make, for each of these worksta¬ 
tions, a copy of the disc you’ve just created for each workstation. 

Multi-Disc SRM 

When an SRM system has more than one hard disc, you need to modify, recompile, and execute 
the CTABLE program to allow access to these discs. This section describes how to perform this type 
of configuration change. 

When more than one shared disc is installed on the SRM system, each disc must have a 
WORKSTATIONS directory. If the directory is write-protected, a TEMP_FILES directory must be 
created. You may also wish to create another SYSTEMS directory. Boot ROMs version 3.0 and 
later search for bootable systems on each disc containing a SYSTEMS directory. 
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CTABLE Modifications 

Near the end of the CTABLE program, just above the manual templates section, a small section of 
code assigns Unit Table entries for the SRM. 

with SRM.dav do 
b e S i ri 

H tea_srm( 46* sc > bat H§|) ! {free) 

tea_srm( 45t sot bat du)5 {for possible use as the system unit} 
end! <with> 

The first tea.s rm entry provides a template for assigning unit #46: to the second disc connected to 
the SRM. To assign that unit, replace the du parameter with the second disc’s volume address. 

To find the correct volume address, use the VOLUMES command at the SRM system controller. 
The resulting display lists the volume address of each volume configured to the system. (With the 
SRM 1.0 operating system, the volume address is shown under the column labeled unit #. With 
SRM 2.0, the column is labeled uol add.) 

To activate the first tea.s rm statement, you must remove the comment delimiter ( { ) from the 
beginning of that line. 

Just below the manual “templates” section of the CTABLE program is another section pertaining 
to units for the SRM. 

{ prefix the primary and secondary SRM unit entries > 

if not unit_prefix_saccessful( '#5:/') then {do nothin*}? 

{tries to set up uuid for possible default unit assignment below} 

U if not unit.pref ix.successf ul ( *'*0£tt*) then 2 ap_as s i *n e d_un i t ( 46 ) 5 {free} 

if not uni t_pref ix_successf ul ( '#45: ' + s rmsyspref ix + s rmn 0 de ( uni tab 1 e '' [45] ♦ sc ) ) then 

if not unit_prefix_successful( '#45: ' + 5 rmsy sp refix) then 
zap_assi*ne d_unit(45) \ 

If you remove the leading comment delimiter ({) from the #46: entry and remove the question 
mark from the literal ' #46/?Pascal will be able to recognize the second hard disc connected to the 
SRM system. 

If you wish to have a Unit Table entry for a particular directory, you can identify the directory by 
including its path in the specification. For example: 

if not unit_prefix_succe 5 sfu1( '#46:/USER/AL ') then 2 ap_assi*ned_unit(46) 5 

If you make this modification be sure to activate both this statement and its accompanying tea.s rm 
procedure tea.s rm( 46* sc* ba* du)i { f r e e > by removing the comment delimiter ({) from the 
beginning of each of the program lines. 

In this example, this modification causes the system to boot with unit #46 assigned to the directory 
“/USER/AL” on the SRM disc selected by the first tea.s rm statement. 
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After all modifications have been made, you can compile CTABLE. Remember that you need to 
enable the $search 'CONFIG: INTERFACE'S Compiler option at the beginning of the program and 
make the INTERFACE library accessible at compile time. You will probably also want to link the 
resultant TABLE object file to itself with the Librarian to conserve disc space. See the procedures in 

the “Modifying the TABLE Program” section of the Pascal Workstation System manual for explicit 
details. 
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Glossary 


Appendix 


directory name A directory name is the same as a remote file name because a directory is a type 
of remote file. Directory names consist of from one to 16 characters, including uppercase and 
lowercase letters, the digits 0 through 9, the underbar ( _ ) character, the period (. ) character, 
and ASCII characters decimal 161 through 254. 

file name The term “file name” refers to local files, not to files on the SRM system (described 
under “remote file name”). A file name consists of one to 10 characters. HP Series 200 file 
names can contain uppercase and lowercase letters, the digits 0 through 9, the underbar ( _ ) 
character, and ASCII characters decimal 161 through 254. 

name With the BASIC language system, a name (used in I/O path name) consists of one to 15 
characters. The first character must be an uppercase ASCII letter or one of the ASCII characters 
decimal 161 through 254. The remaining characters, if any, can be lowercase ASCII letters, 
digits, the underbar ( _ ), or ASCII characters decimal 161 through 254. 

Names may be any combination of uppercase and lowercase letters, but may not look like a 
keyword. Conflicts with keywords are resolved by mixing the letter case in the name. 

node address An integer from 0 through 63 that identifies an SRM device (such as a workstation 
or controller). 

password Passwords are used to protect access to remote files and directories. Passwords consist 
of one to 16 characters. All ASCII characters except “ > ” are allowed. Passwords are assigned 
by the PROTECT statement in BASIC or the Pascal Filer’s Access command. 

remote file name A remote file name consists of one to 16 characters. HP Series 200 remote file 
names can contain uppercase and lowercase letters, the digits 0 through 9, the underbar ( _ ) 
character, the period (. ) character, and ASCII characters decimal 161 through 254. 

SRM The acronym for Shared Resource Management. 

SRM controller The HP Series 200 computer that controls access to the shared resources of the 
Shared Resource Management system. 

SRM controller’s node address An integer in the range 0 through 63 that identifies the SRM 
controller. 

SRM interface The term used to describe the HP 98629A Resource Management Interface 
resident in an SRM workstation computer (not the interface in the SRM controller). 

volume A named portion of mass storage media, which may contain several files. Disc drives 
supported by HP Series 200 mass storage operations contain only one volume per disc. 
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volume name A name used to identify a mass storage volume. The volume name is assigned to 
the volume at initialization. Volume names consist of one to 16 characters including uppercase 
and lowercase letters, the digits 0 through 9, the underbar (_) character, the period (. ) 
character, and ASCII characters decimal 161 through 254. 

volume password A “master” password, assigned at initialization, that allows complete access to 
all files on a mass storage volume. Volume passwords consist of one to 16 characters. All ASCII 
characters except “ > ” are allowed. The volume password supercedes all access restrictions 
placed on files by the PROTECT statement in BASIC or the Pascal Filer’s Access command. 
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SRM Interface STATUS Registers 


Appendix 


B 


Status Register 0 

Status Register 1 

Status Register 2 

Status Register 3 

Status Register 4 
Status Register 5 


Status Register 6 


Status Register 7 


Status Register 8 


Status Register 11 
Status Register 12 



Card Identification 

52 if the Remote Control switch (R) is set to 0 (closed); 180 if switch is set 
to 1 (open). 

Interface Interrupts 

1 = interrupts enabled; 0 = interrupts disabled. 

Interface Busy 
1 = busy; 0 = not busy. 

Interface Firmware ID 

Always 3 (the firmware ID of the HP 98629A interface). 

Not Implemented 
Data Availability 
0 = receiver buffer empty; 

1 = receiver data available but no control blocks buffered: 

2 = receiver control blocks available but no data buffered; 

3 = both control blocks and data available. 

Node Address of the interface 

Node address of the HP 98629A interface installed in this computer 
which is set to the specified select code. The range of node addresses is 0 
through 63. 

CRC Errors 

Total number of cyclic red undanc y check (CRC) errors detected by the 
interface since powerup or ( RESET) . 

Buffer Overflows 

To tal num ber of times the receive buffer has overflowed since powerup 
or (RESET) . 

Amount of available space (number of bytes) in the transmit-data buffer. 
Number of transmission retries performed since powerup or ( RESET) . 















120 









SRM and BASIC 2.0 


Appendix 


This manual describes SRM support of the BASIC 3.0 language system. This appendix summarizes 
the differences between use of SRM with the BASIC 2.0 language system and SRM use with 
BASIC 3.0. 

The primary differences lie in the startup procedures required for bringing up an HP Series 200 
BASIC workstation on the SRM for the first time, and in additional language features implemented 
in BASIC 3.0 (and therefore not supported with BASIC 2.0). 

The first section of this appendix, System Startup From a BASIC 2.0 Workstation, describes the 
initial startup procedure for use with a BASIC 2.0 workstation, and is needed only by a system 
manager installing an SRM system. 

The second section, BASIC 2.0 Language Features, summarizes, by keyword, aspects of BASIC 
2.0 keyword use that differ from the descriptions in this manual’s “BASIC Language Reference” 
section. 

The final section, Additional BASIC 2.0 Information, notes all other portions of the main text of 
the manual that contain information inappropriate or invalid for BASIC 2.0 use on SRM. This 
section also contains information on modifications to existing programs required by BASIC 2.0 that 
are additional to those required for use with BASIC 3.0. 
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System Startup 

From a BASIC 2.0 SRM Workstation 

The following instructions aid the SRM sytem manager in bringing up the SRM system on an HP 
Series 200 BASIC 2.0 workstation for the first time. These instructions assume that the workstation 
has its own floppy disc drive. 

For more information about the directories and files discussed in this procedure, refer to the 
“System Startup” chapter in this manual. 

To bring up the first BASIC 2.0 SRM workstation on your SRM system for the first time, follow 
these steps: 

1. Load into the workstation the BASIC operating system software required for accessing SRM. 

Before proceeding, you should have installed the SRM operating system on the system 
controller by completing steps one through eight in the Initial Installation section of the 
“System Installation” chapter of the SRM Operating System Manual. 

a. With the computer’s power OFF, insert the BASIC 2.0 system disc into the workstation’s 
primary drive (see the operating manual for the workstation or disc drive to determine 
which is the primary drive) then turn the computer’s power ON. Allow the BASIC 
operating system to completely load, then remove the disc. 

b. Insert the Resource Management Access disc (containing the SRM2_1 BIN file) into the 
primary disc drive and type: 

LOAD BIN "SRM2-1 ” ( EXECUTE ) 

If the BIN file is on a disc in an external (non-SRM) drive, you must either ensure that the 
device is the current MASS STORAGE IS device or include the appropriate mass 
storage unit specifier (msus) in the file specifier. Refer to the “Data Storage and Retriev¬ 
al” chapter of the BASIC Programming Techniques manual for further information on 
msus. 

2. Establish the remote device (shared disc) as the workstation’s mass storage device by typing: 

MSI ":REMOTE" ( EXECUTE ) 

which establishes the root of the SRM directory structure (on the shared disc) as the worksta¬ 
tion’s current working directory. You may verify that position within the directory structure 
by using the CAT command. 

3. Create the SYSTEMS and USERS directories on the shared disc by typing: 

CREATE DIR "SYSTEMS" ( EXECUTE ) 
to create the SYSTEMS directory, and: 

CREATE DIR "USERS" ( EXECUTE ) 


to create the USERS directory. 
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4. Install the SRM operating system (from the controller) in the newly-created SYSTEMS 
directory: 

a. Return to the “System Installation” chapter of the SRM Operating System Manual 
and resume the Initial Installation procedure from step 9. 

b. After completing that procedure, return to the workstation you used to create the 
SYSTEMS directory and continue with the following steps. 

5. Place BASIC operating system files into the SYSTEMS directory, following these steps: 

a. Specify SYSTEMS as the current working directory by typing: 

MSI "SYSTEMS" ( EXECUTE ) 

b. Place the disc containing the BASIC Loader Utility into the workstation’s primary drive 
and type: 

COPY "SYSTEM.LD: <device specifier> TO " SYSTEM_LD " ( EXECUTE ) 

where <device specifier> might be HP8290X >700 ,0 on the HP Models 220 and 216 and 
is usually INTERNAL on the HP Models 226 and 236. 

To allow workstations to boot automatically from the SRM, SYSTE M 1 P should be the 
first system file stored in SYSTEMS after the SYSTEM_SRM and CONFIG_SRM files. 

c. Remove the Loader Utility disc from the workstation’s primary drive and insert the disc 
containing the BASIC operating system. Type: 

copy "SYSTEM.BAS: < device specifier > TO "SVSTEM.BAS" ( EXECUTE ) 

After the copy is complete, remove the disc from the drive. 

d. (Optional) You may wish to copy the AP2_1 BIN file and other BIN files from the 
Extended BASIC 2.1 disc. To copy the AP2_1 BIN file, with the Extended BASIC 2.1 
disc in the workstation’s primary drive, type: 

COPY " AP2_ 1: <device specified TO " AP2_ 1" ( EXECUTE ) 

Use the COPY statement as illustrated above to copy other BIN files from the Extended 
BASIC 2.1 disc then remove the disc from the drive. 

e. With the Resource Management Access disc in the workstation’s primary drive, type: 

COPY "SRM2 _ 1 : < device specified TO "SRM2_ 1" ( EXECUTE ) 

6. Create configuration files for use by the BASIC Loader Utility to allow workstations to boot 
automatically from the SRM. Use of the Loader Utility allows workstations with Boot ROM 
version 3.0 or later (but not Boot ROM 3.0L) to boot automatically from the SRM. For more 
information, refer to the Loader Utility Manual. 

a. With SYSTEMS as the current working directory (see step 5a), type: 

LOAD "C0NFIGER: <device specifier> ( EXECUTE ) 

b. Press ( RUN } to create the default configuration file. The screen displays the prompt: 

Enter CONFIG file name 
to which you reply: 


C0NFIG.LD (ENTER) 




















124 


Note 

For workstations whose boot ROMs support automatic booting from 
SRM, at powerup the boot ROM boots the Loader Utility (assuming 
SYSTEM_LD is the first bootable system file in the SYSTEMS direc¬ 
tory). 

The Loader Utility then loads the system and BIN files specified either 
by the workstation’s CONFIG_LDnn file (where nn is the workstation’s 
node address) or by the default configuration file CONFIG_LD if the 
appropriate CONFIG LDnn does not exist. 


c. To specify the BASIC 2.0 operating system as the system to be booted into the worksta¬ 
tion, type: 

SYSTEM.BAS ( CONTINUE ) 

You may also wish to add a key string to the file. The key string is described in the 
Loader Utility Manual. You may continue to enter names of non-scratchable BIN files 
you wish to load, the last of which should be SRM_AP2_1. 


Note 

If you decide to load SRM^AP2_1 via a configuration file, you must 
make SRM_AP2_1 the last entry in the file. You must also follow this 
entry with a blank line. 

When the workstation is powered up and the SRM^AP2_1 BIN file 
loads, a non-fatal error occurs. This is normal and should not affect the 
operation of the SRM system or the workstation or the execution of any 
key string included in the configuration file. 


d. Repeat steps 6b and 6c above to create unique configuration files for each workstation. 
When naming the file (see step 6b), include the workstation’s node address in the file 
name. For example: 

C0NFIG-LD10 

would be the configuration file for the workstation at node address 10. 
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BASIC 2.0 Language Features 

The following table lists keywords used differently on SRM with BASIC 2.0 than with BASIC 3.0 
and describes any differences from the keyword’s description in this manual’s “BASIC Language 
Reference” section. If a keyword is not listed in this table, you may use that keyword with either 
version of BASIC, exactly as described in this manual. 

One major difference is in the BIN files supporting the use of several of the keywords. With BASIC 
2.0, the SRM_AP2_1 (SRM Advanced Programming) BIN file provides enhancements and addi¬ 
tions to the BASIC 2.0 command statements supported on SRM. SRM_AP2_1 requires the BASIC 
2.0 AP2_1 and the SRM2_1 BIN files. 


Keyword 

Differences 

CAT 

Options (SELECT, SKIP, RETURN, NO HEADER, PROTECT, TO String_ 
array$(*), <PROG file>) require the SRM^\P2_1 BIN file. 

The catalog listing header shows only the name of the directory or file being listed, 
not the full path to that directory or file, as in illustrations (valid only for BASIC 3.0). 

LOAD BIN 

BIN files cannot be loaded from an external device unless the BIN file to access that 
device is already present in the workstation. 

LOAD KEY 

Requires SRM^\P2_1 BIN file. 

LOADSUB 

All versions of this command except LOADSUB ALL FROM ... require the 
SRM-AP2_1 BIN file. 

PLOTTER IS 

Not supported with BASIC 2.0. Cannot be used with the SRM 1.0 operating 
system. 

PRINTER IS 

Not supported with BASIC 2.0. Cannot be used with the SRM 1.0 operating 
system. 

RESET 

Requires SRM^AP2_1 BIN file. 

RE-STORE BIN 

A valid statement in BASIC 2.0 (not in BASIC 3.0). See description on the follow¬ 
ing page. 

RE-STORE KEY 

Requires SRM_AP2_1 BIN file. 

STORE 

This statement creates a PROG file and stores the currently resident BASIC prog¬ 
ram and all normal BIN files currently in memory. 

STORE BIN 

A valid statement in BASIC 2.0 (not in BASIC 3.0). See following description. 

STORE KEY 

Requires SRM_AP2_1 BIN file. 

STORE SYSTEM 

Not a valid BASIC 2.0 statement. 

SYSTEMS 

Only SYSTEM$(“MSI”) is valid with BASIC 2.0. Does not return the full directory 
specifier (including directory path) as with BASIC 3.0. Returns only the directory’s 
name and full remote msus. 

TRANSFER 

Requires SRM^\P2_1 BIN file. 
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RE-STORE BIN 


With SRM, RE-STORE BIN creates a BIN file in a remote directory and stores all normal BIN files in 
the file. For a description of RE-STORE BIN with local files, refer to the BASIC 2.0 Language 
Reference. 


(re-: 


STORE BIN 


5 )— 


remote file 
specif ier 


Example Statements 

RE-STORE BIN "Phvrec" 

RE-STORE BIN "Dir<RWpass>/Bin_proS<RWpass>" 

Semantics 

READ and WRITE access capabilities are required on the directory immediately superior to that in 
which the file is to be re-stored and on the BIN file (if it exists). 

Attempting to use RE-STORE BIN with an existing file that is not a BIN file results in an error. 
Passwords assigned to an existing file are retained when a RE-STORE BIN is performed on the file. 
If you specify the wrong password on a protected file, the system returns an error message. 

If the file does not already exist, RE-STORE BIN performs the same action as STORE BIN. 
Including a password in the RE-STORE BIN statement’s remote file specifier does not protect the 
file. Passwords are assigned only with PROTECT. 

With SRM, temporary files may by left on the disc by RE-STORE BIN if (CLR I/O) or ( RESET ) are 
pressed or a TIMEOUT occurs during the RE-STORE BIN operation. The name of the temporary 
file is an eight-digit number derived from the value of the workstation’s real-time clock when the 
interruption occurred. You may wish to check the contents of any such file before purging. 
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STORE BIN 


With SRM, STORE BIN creates a BIN file in a remote directory and stores all normal BIN files 
currently resident in memory in the file. For a description of STORE BIN with local files, refer to the 
BASIC 2.0 Language Reference. 


( STORE BIN ZH 


remote file 
spec i fier 


Example Statements 

STORE BIN "FFT" 

STORE BIN "Di KRWpass >/Bin_p ro sf" 

Semantics 

READ and WRITE access capabilities are required on the directory immediately superior to that in 
which the file is to be stored. 

STORE BIN opens the remote file in exclusive mode (denoted as LOCK in a CAT listing) and 
enforces that status on the file until the STORE BIN is complete. While in exclusive mode, the file is 
inaccessible to all SRM workstations other than the one executing the STORE BIN. 

Including a password in the STORE BIN statement’s remote file specifier does not protect the file. 
Passwords are assigned only with PROTECT. 
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Additional BASIC 2.0 Information 

The following information in the main text of this manual is invalid for BASIC 2.0 use of SRM (all 
section titles refer to the chapter on “HP Series 200 BASIC Workstation Use on SRM”): 

To execute statements in BASIC 2.0, use the ( EXECUTE ) ke y on the HP 98203B keyboard or the 
key labeled [ EXECUTE ) on the HP 98203A keyboard. The (ENTER) key is not an execution key for 
BASIC 2.0 commands and statements. BASIC 2.0 does not support the HP 46020A keyboard. 

Throughout the section, “Using Your BASIC Workstation on SRM,” 

• All example catalog listings show the header format used with BASIC 3.0. With BASIC 2.0, the 
header lists only the name of the directory rather than the full path name to the directory. 

Similarly, SYSTEMS (“MSI”) returns the full directory specifier (including the path to the 
directory) with BASIC 3.0, but only the current directory’s name with BASIC 2.0. 

In the section, “Booting From the SRM,” 

• BASIC 2.0 does not allow you to load BIN files from a device into the workstation unless the 
BIN file to access that device is present. 

• The Loader Utility can be used to load BIN files from SRM with BASIC 2.0 but not with BASIC 
3.0. You must use the Loader Utility to boot BASIC 2.0 into your workstation from SRM. 

• The SYSBOOT command is not a valid BASIC 2.0 command. 

• BASIC 2.0 does not recognize “autostart” files if you are using the Loader Utility. All automatic 
configuration is specified in the Loader Utility’s configuration files (CONFIG_LD or 
CONFIG_LDnn). 

• In the BASIC 2.0 remote msus, the default value for the interface select code of a workstation’s 
SRM interface (HP 98629A) is 21. The default controller’s node address is 0. 

Modifying Existing Programs 

to Access Shared Printers or Plotters 

Spooling 

With BASIC 2.0, programming for printer and plotter spooling requires replacing the PRINTER IS 
or PLOTTER IS statements with routines that implement those functions. 

For example, in BASIC 2.0, you cannot use the sequence: 

PRINTER IS REMOTE" 

PRINT The_data$ 

to spool data to the shared printer. Instead, you must create a file in the spooler directory and 
output strings to the file. After the file is closed, the SRM controller automatically places the file in a 
“waiting list.” The SRM controller locks the file while it is being printed, then purges the file when 
printing is completed. 
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Sending information to a spooler file may require four main changes to a program: 

• Replacing all PRINTER IS statements with a CALL to a printer-selecting subprogram that 
assigns an 1/0 path name to the designated device or file. 

• Replacing all PRINT statements with OUTPUT statements to access the printer to which the 
I/O path name has been assigned. For example: 

500 OUTPUT @Printeri"Final Results" 

• If double-spaced output is not desired, changing all numeric values to string values with the 
VAL$ function. For example: 

510 FOR Place=l TO 10 

520 OUTPUT @PrinteriUAL$(Place)&" "$Na(ne$(Place) 

530 NEXT Place 

(Otherwise a carriage retum/line feed is sent after each item in the OUTPUT statement.) 

• When a printing segment of the program is done, closing the I/O path (using, for example, 
ASSIGN @ ... TO *) to allow the SRM controller to print the file’s contents. The spooler will 
not print the contents of an open file. 

Formatted Output 

Formatted output (OUTPUT...USING...) cannot be directed to spooler files, which are ASCII files. 
However, formatting can be accomplished by declaring a string variable, outputting to the string, 
and then outputting the string to the spooler file. The following program shows an example of this 
technique: 

100 DIM Out put$C80] 


1500 ! Center title by us in* iwa*e specifiers* 

1510 OUTPUT 0ut p ut$ USING "# ,34X*K"5"Final Results" 
1520 OUTPUT @Printer»0utput$ 

1530 ! 

1540 FOR Place-1 TO 10 

1550 OUTPUT Out put$ USING 1560 5Place*Name$(Place) 

15G0 IMAGE # »DD *5X *40A 

1570 OUTPUT @Printer50utput$ 

1580 NEXT Place 


Note 

If the EOL-suppression image specifier (#) is not used, a carriage return 
and line feed will be printed as the last two characters in the string 
variable, causing double-spaced output. 
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